Skip to content

docs: refresh READMEs#2165

Merged
Mirko-von-Leipzig merged 32 commits into
nextfrom
mirko/readmes
Jun 2, 2026
Merged

docs: refresh READMEs#2165
Mirko-von-Leipzig merged 32 commits into
nextfrom
mirko/readmes

Conversation

@Mirko-von-Leipzig

Copy link
Copy Markdown
Collaborator

This PR updates all READMEs for v0.15.

I've tried to standardize around:

  • Crate READMEs are simple and redirect to the main README
  • Main README summarizes and redirects to the official documentation

This should reduce the churn overall, these are constantly outdated.

I've also introduced markdown formatting and linting - this currently only impacts the readme's and not the docs. I'll revisit the latter when I refresh these for v0.15.

We're also collecting dotfiles at a somewhat egregious pace, so I've moved them into .config.

@Mirko-von-Leipzig Mirko-von-Leipzig added documentation Improvements or additions to documentation no changelog This PR does not require an entry in the `CHANGELOG.md` file labels Jun 1, 2026
@Mirko-von-Leipzig Mirko-von-Leipzig marked this pull request as ready for review June 1, 2026 12:25
Comment thread .config/rustfmt.toml

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Ah - nice that we can move all of these into the .config directory. We should do something like this in other repos too.

cc @mmagician @huitseeker @igamigo @WiktorStarczewski

Comment thread docs/internal/src/index.md Outdated
Comment thread docs/internal/src/monitoring.md Outdated
Comment thread docs/internal/src/components.md Outdated

@sergerad sergerad left a comment

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.

Thanks this is better. Might as well fix the 404s for the miden-docs

@bobbinth bobbinth left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good! Thank you!

Comment thread README.md
Comment on lines +8 to +10
[ci-badge]: https://github.com/0xMiden/node/actions/workflows/ci.yml/badge.svg
[ci-link]: https://github.com/0xMiden/node/actions/workflows/ci.yml
[developer-docs]: https://0xMiden.github.io/node/index.html

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Why break out these specific links like so?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

The AI did it as part of a pass improving the legibility (shortening line length), and I didn't really mind enough to undo :) I can revert it?

@Mirko-von-Leipzig Mirko-von-Leipzig merged commit 6eb7f74 into next Jun 2, 2026
23 checks passed
@Mirko-von-Leipzig Mirko-von-Leipzig deleted the mirko/readmes branch June 2, 2026 05:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation no changelog This PR does not require an entry in the `CHANGELOG.md` file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants