David O'Brien
David O'Brien
Need something to help first-timers get involved; a general process doc that covers the basics.
Was https://bugzilla.redhat.com/show_bug.cgi?id=905707 Nothing left in that bug that prevents us from transferring it here with everything else.
http://stylepedia.net/#sect-Red_Hat_Technical_Publications-Writing_Style_Guide-Grammar-Sentence_Structure The example here is not a good one. "People read" is not a suitable alternative or reconstruction of the original. Table 2.4. Example Improvement The individual member of the...
e.g., "Do not hyphenate a compound that includes an adverb ending in -ly, whether it comes before or after the noun. This is described in Chicago Manual of Style 7.82."...
We often say (e.g.) "Use the one-word form" but it doesn't help if people look up the two-word or hyphenated form and it's not there. It just makes it harder...
From IRC conversation: "Several zones can be grouped into a zonegroup, previously known as a region." trying to work out if "zonegroup" is a formal name, proper noun, or whatever...
The existing entry is brief and doesn't cover many use cases. IBM and AP and CMoS differ in some areas. Need to narrow down the variables.
There are many opportunities to improve the use of xrefs, such as "right-click" with ref to "double-click", and "must" with ref to "required", and so on.
https://stylepedia.net/style/6.2/#s This entry uses "exclamation mark" but everywhere else uses "exclamation point". shebang n. Refers to the character sequence consisting of the number sign and exclamation mark (#!) at the...
This was discussed at length in WN and a revised and more comprehensive description is in place in the CSG. The CSG is not public so we need to harvest...