Skip to content

Conversation

@tushar-Rathore023
Copy link

What changed

Minor formatting improvements to README documentation for readability.

Why

Improves consistency and clarity of documentation.

Testing

  • cargo fmt

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Jan 10, 2026
@pepijnve
Copy link
Contributor

While documentation improvements are of course much appreciated, I'm not sure if just changing some whitespace is useful. This doesn't really change the rendered version of the documentation in any way, so the argument that this improves clarity of documentation doesn't really hold.

Additionally there's already an automated task in place to check that the documentation is formatted as desired which is now failing in this MR. If the documentation layout rules/checks need to be updated in order to improve things then that changing those and automatically applying them would be a more useful contribution.

@tushar-Rathore023
Copy link
Author

While documentation improvements are of course much appreciated, I'm not sure if just changing some whitespace is useful. This doesn't really change the rendered version of the documentation in any way, so the argument that this improves clarity of documentation doesn't really hold.

Additionally there's already an automated task in place to check that the documentation is formatted as desired which is now failing in this MR. If the documentation layout rules/checks need to be updated in order to improve things then that changing those and automatically applying them would be a more useful contribution.

Thanks for the feedback! I understand the concern. I’ll close this PR and look for a more substantial documentation improvement.

@tushar-Rathore023
Copy link
Author

While documentation improvements are of course much appreciated, I'm not sure if just changing some whitespace is useful. This doesn't really change the rendered version of the documentation in any way, so the argument that this improves clarity of documentation doesn't really hold.

Additionally there's already an automated task in place to check that the documentation is formatted as desired which is now failing in this MR. If the documentation layout rules/checks need to be updated in order to improve things then that changing those and automatically applying them would be a more useful contribution.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants