Skip to content

Copyedit a few top-level Markdown files #2002

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

Merged
merged 4 commits into from
May 8, 2025
Merged

Conversation

EliahKagan
Copy link
Member

@EliahKagan EliahKagan commented May 8, 2025

This does some low-stakes, fairly minor copyediting of top-level .md files other than:

  • The ones that don't seem to benefit from any changes or where changes would not be appropriate.
  • DEVELOPMENT.md.

This does not include changes to DEVELOPMENT.md because:

  • It seems like it would be easier, and also clearer in the history it would produce, to copyedit it together with some other changes in it that would require review.
  • The motivation of this PR is to avoid a conflict (or scope creep, or an unnecessarily complicated situation for reviewers) in a subsequent PR that will edit README.md (to propose another installation method). This PR therefore only edits other .md files besides README.md where it was quick and easy to do so.

In effect this PR can be considered what was outscoped from the forthcoming PR that will propose an additional installation method, just I am doing this PR first instead of afterwards.

EliahKagan added 4 commits May 8, 2025 16:12
- Make "Download from" headings to be clearer and more consistent.
- Specify `sh` in applicable code fences, for syntax highlighting.
- Change code spans to code blocks (fences) in a couple places.
- Tiny formatting adjustments, and slight rewording around a fence.
- Add h1 heading (as most other top-level .md files have them).
- Remove a misplaced empty h4 sub-heading.
- Fix spelling, and slightly adjust hyphenation for clarity.
- Make capitalization consistent and capitalize "Git" in "Git LFS".
- If not a command or binary, replace "git" and "`git`" with "Git".
- Replace "Pack" with "`Pack`" since we're talking about the type.
- Make non-rendered aspects of Markdown code style more consistent.
This is only to make the information that is already there clearer.
It does not attempt to update the information to be more current
(nor is this an attempt to advance any kind of policy changes).

- Improve consistency in use of code spans and italics.
- Have all references to "semver" be the hyperlink.
- Fix a minor spelling error.
- Very slightly adjust punctuation for clarity and consistency.
- Add h1 heading (as most other top-level .md files have them).
- Make capitalization more consistent (preferring existing style).
- Adjust code formatting and italics, to clarify what is code.
- Tiny punctuation change for consistency.
@EliahKagan EliahKagan enabled auto-merge May 8, 2025 20:41
@EliahKagan EliahKagan merged commit ac5f33d into GitoxideLabs:main May 8, 2025
21 checks passed
@EliahKagan EliahKagan deleted the md branch May 8, 2025 21:22
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.

1 participant