Hi all. I had a lot of trouble understanding the #Prefix and namespace section, so I did my best to make it more readable.
Specifically confusing was term vs. term:
, so I tried to make that more consistent within that section. When I see code
, the programmer part of my brain thinks "oh, I type this in." Italics is used in prose for emphasis, is not very visually distinctive, and therefore doesn't trigger the same "oh, I must do something!" response. So I hope it makes sense why I think term:
is preferable here.
Secondly, the HTML <kbd>
tag is typically used to denote hotkeys, such as Control+c, but I had a look at the MDN docs and it seems that using it for strings of literal text input is OK, too. What would be the preference then, <kbd>
or <code>
?
Would it be helpful to do a pass over the whole article, or the whole batch of CirrusSearch user-facing documentation, in order to make the use of ''term''
/ <code>term</code>
/ <kbd>term</kbd>
more consistent? --Ernstkm (talk) 03:17, 12 November 2023 (UTC)