How to use tags in the handbook?
A few questions
- If I'm entering Ctrl + Z (say) in the handbook, I enter:
with double tags around each keyboard key.
However I've noticed that some use the form:
with single opening and closing tags around the keys and an extra opening and closing tag around the whole expression.
Which is the correct form? The problem with the second is that it causes the "+" signs to reduce in size. But I've never quite understood the need to double up the tags in the first place..
- There is also an apparent problem with a tag of the form:
When it is used in a standard paragraph it is "normal" size but when it is in a list the text size is reduced. You can see this in the list at the bottom of Editing notes and rests.
Comments
1 The double 'inner' tags are superfluos, so the shorter one should be prefered (and way used in the 3.x handbook thoughout), but the longer isn't really wrong either.
2. That seems a CSS issue?
Indeed, the second form of the shortcut is "correct". And yes, I noticed the questionable formatting of the menu commands as well.
There are other areas where I'm realizing we could use some better style guidelines. Like, how we handle lists of the form "shortcut: description of command" (use of colon versus hyphen versus en dash versus em dash, capitalization of the description, whether the description comes first or not, what additional formatting might be used, etc).