David O'Brien
David O'Brien
The current TOC is all over the place, with different heading designs used in different places. This has been in my backlog for quite a while but I've never had...
This is not covered well (at all?). Need to make it easy for people to determine how and when to use non-breaking spaces. Maybe an entry in the Usage Dictionary...
https://stylepedia.net/style/5.1/#punc-names The layout of table 2.7 is not great. It's not terrible, but I think it could be better. Please offer suggestions. @StyleGuides/style-guide-committers @PatSharp99
From the Word Nerds meeting: military-grade security This description is used only when discussing government or military security requirements. Do not use to describe generic security or to emphasize security....
This is really old and needs fixing. Refer to https://github.com/RedHatTraining/skeleton/discussions/355 and also https://stylepedia.net/docbook/4.0/#using-references for info.
When we create rules in Vale we need to make sure that they're based on solid guidance, and that we can refer writers to this guidance for more info. `allow.yml`...
Currently this only refers (obliquely) to introductions to products, but the topic actually applies to introductions in general.
I don't know that there is any formal rule about this but rather general consensus among editors and IDs not to write titles as questions except in FAQs and similar....
Initial question from @nmuller66 Do we have the guidance about avoiding object names in headings documented anywhere? Examples: Virt-Launcher Pods PersistentVolumes PersistentVolumeClaims Initial suggestion from @daobrien I'd hazard a guess...
Some modern GUIs use icons and buttons that cannot be easily described or recognised (cf `Save` and `Open` and similar) and neither do they have a tooltip or other help...