Skip to content

Apply best practices to cargo.toml#230

Merged
hannesdejager merged 1 commit into
bolcom:masterfrom
koenw:cargo_toml_best_practices
Jul 19, 2026
Merged

Apply best practices to cargo.toml#230
hannesdejager merged 1 commit into
bolcom:masterfrom
koenw:cargo_toml_best_practices

Conversation

@koenw

@koenw koenw commented May 27, 2026

Copy link
Copy Markdown
Contributor
  • Point the homepage field to the actual homepage The cargo.toml manifest documentation explicitly mentions the homepage field should not be redundant with the documentation or repository values and should instead only be used if a dedicated homepage for the project exists.

    Additionally, since users already have a link to the source code (from the repository field) we can be more useful to users by linking them to the actual homepage.

  • Point the documentation field to the documentation page on the website Similarly the documentation field should be pointing to a website hosting the project's documentation.

* Point the `homepage` field to the actual homepage
  The [`cargo.toml` manifest
  documentation](https://doc.rust-lang.org/cargo/reference/manifest.html)
  explicitly mentions the `homepage` field should not be redundant with
  the `documentation` or `repository` values and should instead only be
  used if a dedicated homepage for the project exists.

  Additionally, since users already have a link to the source code (from
  the `repository` field) we can be more useful to users by linking them
  to the actual homepage.
* Point the `documentation` field to the documentation page on the
  website
  Similarly the `documentation` field should be pointing to a website
  hosting the project's documentation.
@hannesdejager

Copy link
Copy Markdown
Collaborator

So nice to get an MR from you Koen, thankyou!

@hannesdejager
hannesdejager merged commit 175b9d6 into bolcom:master Jul 19, 2026
14 checks passed
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