At the moment we do not have a consistent style for capital letters in the titles in the tag. Example: 7.1.3. Language Settings 7.1.4. The ThinLinc session life cycle I personally prefer the second style.
Seems to be a lack of consensus around these things. Wikipedia prefers sentence case on everything, while most press style guides lean heavily towards title case. Some more nuance in this guide from APA: https://blog.apastyle.org/apastyle/2012/03/title-case-and-sentence-case-capitalization-in-apa-style.html And here is also a summary: https://capitalizemytitle.com/#capitalizationrules
A minor argument towards using title case is the way cross-references look in the new reStructuredText documentation. Previously we had references that could look like this: > See LOWERCASE_LOGIN_NAME in Section 7.8, “ Client configuration storage ” for details. Now they they look like this: > See LOWERCASE_LOGIN_NAME in Configuration Parameters Used by the ThinLinc Client for details. The title case makes it easier to identify this as a reference to another section. If it was written in sentence case it'd look even more like just some more text. The problem is especially significant in the PDF since we don't get different coloring or underscores for links.
(In reply to Samuel Mannehed from comment #2) > The title case makes it easier to identify this as a reference to another > section. If it was written in sentence case it'd look even more like just > some more text. The problem is especially significant in the PDF since we > don't get different coloring or underscores for links. This is somewhat mitigated now since we have added color to links in the PDF as well.
This is also an issue in the user interface. At least tlclient has varying style for labels.
(In reply to Pierre Ossman from comment #4) > This is also an issue in the user interface. At least tlclient has varying > style for labels. For UIs, it's a complete mess with no winning standard. GNOME advocates using Title Case for a lot of graphical elements: https://developer.gnome.org/hig/guidelines/writing-style.html We can also see that the HIG itself uses Title Case everywhere. KDE seems to have almost identical approach: https://develop.kde.org/hig/style/writing/capitalization/ Mozilla also uses Title Case in Firefox and Thunderbird in a manner similar to GNOME: https://design.firefox.com/photon/copy/capitalization.html (Note the odd exception for Android. Also note that Firefox menus are still in sentence case, despite what their design document states.) Their homepage seems to lean heavily towards Title Case, but it's not everywhere. MDN is a bit of a mess, with both styles applied pretty much at random. Google, however, uses Sentence case in Chrome, and that's also what their developer documentation recommends: https://developers.google.com/style/capitalization https://developers.google.com/style/ui-elements Their web pages are also mostly Sentence case, with Title Case sneaking in here and there. Note, however, that their menus are Title Case on macOS, but Sentence case on other platforms. Microsoft seems to be consistent in Sentence case, both in their UIs and on their web pages. This is also what they document in their style guide: https://docs.microsoft.com/en-us/style-guide/capitalization Apple uses mostly Title Case in their applications. They don't have any single summary of this in their style guide, rather it's spread out over all the different UI elements in their HIG: https://developer.apple.com/design/human-interface-guidelines/ Their homepage seems to use Title Case for top headings, and sentence case for any sub-headings.
Should probably also poke someone to also clean up our website, as it also has a mix.
We've now decided to go with Wikipedia's approach, which is sentence case for almost everything. The exception being titles for works, which occurs very rarely for us. Details here: https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Titles_of_works#Capital_letters We've picked this because it is likely easier for everyone to get right, and there is no compelling reason for either side. There are major platforms in both camps.
