Skip to content

docs: fix typos, grammar, and improve contributing docs#2159

Open
Dark-Brain07 wants to merge 9 commits intostx-labs:mainfrom
Dark-Brain07:feature/docs-and-improvements
Open

docs: fix typos, grammar, and improve contributing docs#2159
Dark-Brain07 wants to merge 9 commits intostx-labs:mainfrom
Dark-Brain07:feature/docs-and-improvements

Conversation

@Dark-Brain07
Copy link
Copy Markdown
Contributor

Description

Spotted a few things while going through the docs:

  • Fixed typo "branc" → "branch" in contributing section
  • Fixed SDK path reference (was duplicated pointing to wasm)
  • Fixed broken Code of Conduct link
  • Completed the "Contribution Prerequisites" section that was marked as WIP
  • Added more checklist items to PR template (build check, formatting, docs)
  • Fixed "an other" → "another" and "all PR" → "all PRs" grammar issues
  • Added comments to codecov.yml for clarity
  • Added tip for Windows/Linux users about installation

Nothing major, just some housekeeping.

Checklist

  • Tests added in this PR (if applicable)
  • Code builds without errors
  • Documentation updated

Comment thread .github/CONTRIBUTING.md
Comment on lines +19 to +26
Before you start contributing, make sure you have:

- Rust (>=1.89.0) and Cargo installed
- Node.js (>=v24.4.1) and npm (>=11.5.2) for SDK work
- Git for version control
- A code editor (VSCode recommended for the extension support)

For more details, see the [README](../README.md#prerequisites).
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Not sure if that's useful as it, but I like the idea of removing this old "wip".

So that we don't have to update the versions in the future, I'd recommend setting:

  • Rust latest stable
  • Node latest LTS

Remove git and vscode, at this point, we expect contributors to know what they are doing.

And we could move the whole README prerequisites section here

Comment on lines +18 to +19
- [ ] Code builds without errors (`cargo build`)
- [ ] Code formatted with `cargo fmt-stacks`
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

The CI while check that, no need for additional checkboxes

Comment thread README.md

> To check out more installation methods, click
> [here](https://docs.hiro.so/stacks/clarinet#installation)
> [here](https://docs.hiro.so/stacks/clarinet#installation).
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Docs link updated (see conflicts I guess)

@hugo-stacks
Copy link
Copy Markdown
Collaborator

Thanks @Dark-Brain07
I left a few suggestions

@Dark-Brain07 Dark-Brain07 force-pushed the feature/docs-and-improvements branch from 93f120f to 08993e7 Compare February 14, 2026 09:46
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.

2 participants