Skip to content

Commit

Permalink
Various fixes (#512)
Browse files Browse the repository at this point in the history
  • Loading branch information
@julian-cable
julian-cable committed Aug 4, 2023
1 parent 4a0e728 commit 02fcf95
Show file tree
Hide file tree
Showing 5 changed files with 8 additions and 27 deletions.
9 changes: 4 additions & 5 deletions en-US/Design.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
<title>Capitalization</title>
<para>
The standard for all Red&nbsp;Hat technical documentation is title case for all headings and titles.
Table headings, procedure headings, and formal paragraph titles fall under this heading; standard title case capitalization rules apply.
Table headings and procedure headings fall under this heading; standard title case capitalization rules apply.
</para>
</formalpara>
<para>
Expand Down Expand Up @@ -1277,13 +1277,12 @@ Book Title by First name Surname; Publisher.
</programlisting>

<para>
For example, <citetitle>Maximum RPM</citetitle> by
<author>
For example, <citetitle>Maximum RPM</citetitle> by Edward Bailey; Red&nbsp;Hat Press.
<!-- <author>
<firstname>Edward</firstname>
<surname>Bailey</surname>
</author>
; Red&nbsp;Hat Press.
</author> -->
</para>
<formalpara id="other-websites">
<title>Referencing Other Internet Sites</title>
Expand Down
4 changes: 2 additions & 2 deletions en-US/Grammar.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -277,7 +277,7 @@
</listitem>
<listitem>
<para>
If the restatement contains the word <emphasis>he</emphasis>, <emphasis>she</emphasis>, <emphasis>they</emphasis>, I<emphasis>I</emphasis>, or <emphasis>we</emphasis>, then use <emphasis>who</emphasis> or <emphasis>whoever</emphasis>. "Do you think he would mind?" "Who do you think would mind?" "She's walking in the door." "Who's walking in the door?"
If the restatement contains the word <emphasis>he</emphasis>, <emphasis>she</emphasis>, <emphasis>they</emphasis>, <emphasis>I</emphasis>, or <emphasis>we</emphasis>, then use <emphasis>who</emphasis> or <emphasis>whoever</emphasis>. "Do you think he would mind?" "Who do you think would mind?" "She's walking in the door." "Who's walking in the door?"
</para>

</listitem>
Expand All @@ -300,7 +300,7 @@
<title>Sentence Length</title>
<para>
Try not to pack too much information into one sentence.
In technical documentation, try not to exceed 30 words in a sentence.
In technical documentation, try not to exceed 40 words in a sentence.
Keep it short.
The following sentence is a bad writing example:
</para>
Expand Down
2 changes: 1 addition & 1 deletion en-US/Language.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -704,7 +704,7 @@
<term>shoot yourself in the foot</term>
<listitem>
<para>
To "shoot yourself in the foot" indicates that you did something to harm your own cause, or acting against your own best interests. Remove the sentence; it should be self-evident from the surrounding information. (Found this statement alongside the "double-edged sword" comment with an added note about "preserving all your toes".)
To "shoot yourself in the foot" indicates that you did something to harm your own cause, or acting against your own best interests. Remove the sentence; it should be self-evident from the surrounding information.
</para>

</listitem>
Expand Down
2 changes: 1 addition & 1 deletion en-US/P.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
<warning>
<title>Marketing, Brand, Customer Portal Usage</title>
<para>
For all-caps text, such as banners, use "&lt;VARIANT&gt;-ASERVICE" for the spelled-out version. The same abbreviation is used across all groups.
For all-caps text, such as banners, use "&lt;VARIANT&gt;-AS-A-SERVICE" for the spelled-out version. The same abbreviation is used across all groups.
</para>

</warning>
Expand Down
18 changes: 0 additions & 18 deletions en-US/Translation.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -272,27 +272,18 @@
<para>
To obtain the file name of the default kernel with the <command>grubby</command> command:
</para>
<para>
...
</para>

</listitem>
<listitem>
<para>
Finding the index number of the default kernel:
</para>
<para>
...
</para>

</listitem>
<listitem>
<para>
Use the <command>grubby</command> command to persistently change the default kernel:
</para>
<para>
...
</para>

</listitem>

Expand All @@ -304,27 +295,18 @@
<para>
Obtain the file name of the default kernel with the <command>grubby</command> command:
</para>
<para>
...
</para>

</listitem>
<listitem>
<para>
Find the index number of the default kernel:
</para>
<para>
...
</para>

</listitem>
<listitem>
<para>
Use the <command>grubby</command> command to persistently change the default kernel:
</para>
<para>
...
</para>

</listitem>

Expand Down

0 comments on commit 02fcf95

Please sign in to comment.