: Re: Bridging the gap between colloquial usage and technical meaning of terms Frequently, at least in the software world, it seems that terms get assigned a meaning over time that is more general

@Megan928

Vote Up Vote Down

I see a certain amount of benefit in pedantry - you are signaling to a knowledgeable in group, that your documentation, and by inference your product, follows expected standards. Whenever I notice a deviation from the strict definition I wonder where else is this product going to let me down.

However, as pointed out by bookeater - use of a glossary helps to define terminology "for the rest of us" - and therefore doesn't exclude the novice from using the document, it also does not impede the flow of the document itself.

Furthermore, you can keep to the use of proper definitions where possible (e.g RESTful), and create new terms such as REST-like as common usage diverges from the original meaning.

(0)

Login to post a comment!