Skip to content

doc: edits for consistency, style guide alignment#1325

Merged
roosterfish merged 2 commits into
canonical:mainfrom
elijahgreenstein:style-guide
Apr 14, 2026
Merged

doc: edits for consistency, style guide alignment#1325
roosterfish merged 2 commits into
canonical:mainfrom
elijahgreenstein:style-guide

Conversation

@elijahgreenstein
Copy link
Copy Markdown
Contributor

This PR includes edits intended to bring the documentation into alignment with inclusive language and style guide standards:

  1. This PR replaces "see" (as in see <cross reference>) with alternatives such as "refer to", "consult", and "visit."
  2. This PR removes Latinisms by replacing "e.g." with "for example."

This PR also aims for consistency in punctuation by removing colons that precede in-line cross references (for example, Refer to: <ref> for details becomes Refer to <ref> for details).

Checklist

@github-actions github-actions Bot added the Documentation Documentation needs updating label Apr 10, 2026
minaelee
minaelee previously approved these changes Apr 11, 2026
Copy link
Copy Markdown
Contributor

@minaelee minaelee left a comment

Choose a reason for hiding this comment

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

Thanks!

roosterfish
roosterfish previously approved these changes Apr 13, 2026
@roosterfish
Copy link
Copy Markdown
Contributor

Needs a rebase.

This commit brings docs into alignment with inclusive language standards
by replacing "see" (for example, "see <cross reference>") with
alternatives such as "refer to", "visit", and "consult".  It also seeks
to ensure consistency in punctuation by removing colons when cross
references appear mid-sentence. For example: "Refer to: <cross
reference> for details." becomes "Refer to <cross reference> for
details."

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
Change "e.g." to "for example".

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
Copy link
Copy Markdown
Contributor

@roosterfish roosterfish left a comment

Choose a reason for hiding this comment

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

Thanks

@roosterfish roosterfish merged commit e1bd5d4 into canonical:main Apr 14, 2026
15 checks passed
@elijahgreenstein elijahgreenstein deleted the style-guide branch April 15, 2026 23:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Documentation needs updating

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants