Skip to content

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