Skip to content

Further 7.2 enhancements#675

Open
julian-cable wants to merge 3 commits intodevfrom
jcable/7.2-keys
Open

Further 7.2 enhancements#675
julian-cable wants to merge 3 commits intodevfrom
jcable/7.2-keys

Conversation

@julian-cable
Copy link
Collaborator

No description provided.

@julian-cable julian-cable linked an issue Feb 13, 2026 that may be closed by this pull request
@julian-cable julian-cable marked this pull request as ready for review February 13, 2026 18:14
Copy link
Contributor

@rclee33 rclee33 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggested some edits and added some notes.

In some notes, I ask about possibly including additional keys in the "Keyboard Keys" table. But, perhaps some of those are unique to specific environments, such as MacOS. (But, even so, additional keys might be worth including, not sure.)

Say "added value" or "valuable".
Or be more specific, for example, "adds value by improving productivity".
Jargon; do not use.
Instead, try "learn", "train", "educate", or a similar plain-language alternative.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Instead, try "learn", "train", "educate", or a similar plain-language alternative.
Instead, use "learn", "train", "educate", or a similar plain-language alternative.

Refer to <xref linkend="refer-object-names"/>.</para>
</listitem>
<listitem>
<para>Added an further use case for using a non-breaking space: In a formal title, placed before a numeral that denotes part of a sequence.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<para>Added an further use case for using a non-breaking space: In a formal title, placed before a numeral that denotes part of a sequence.
<para>Added a further use case for using a non-breaking space: In a formal title, placed before a numeral that denotes part of a sequence.

]>
<section id="punctuation">
<title>Punctuation</title>
<title>Punctuation, Characters, and Key</title>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For clarity, I suggest updating the title with more detail: "Punctuation, Special Characters, and Keyboard Keys"


</row>
<row>
<entry> F1 </entry>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What about "Fn" or "Function" as its own key? That is, with no number.


</row>
<row>
<entry> Ctrl </entry>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What about "Command" or "Cmd" key?


</row>
<row>
<entry> PgDn or Page Down </entry>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What about "Option" key?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve guidance on keyboard key names

2 participants