Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Various fixes #512

Merged
merged 1 commit into from
Aug 4, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 4 additions & 5 deletions en-US/Design.xml
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
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
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
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
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