Here’s a question that came in this week – this person is somewhat ahead:
Q. “On the tag website it states: ‘Simply put the tag phrase in parentheses directly after the element is addressed in your documentation, or at the end of the paragraph.’ But – I thought you now wanted us to put the tags into a table with the tag in one column and how we met it in another?”
A. You get to choose.
For example, where it’s obvious there’s a lot of material to go with a tag, then it should probably be an element in the left column.
Where it might be one little bitty thing that is also embedded inside another bigger thing, it makes sense to just tag it where it would naturally occur.
We have no metric to dictate where one is more appropriate than the other. In the end, we’re going to be checking things off and struggling to find the things that don’t match or seem to be missing. If your documentation avoids this later problem, I won’t even notice whether it’s a column or a tag!
