Skip to content

Apply best practices to cargo.toml#230

Open
koenw wants to merge 1 commit into
bolcom:masterfrom
koenw:cargo_toml_best_practices
Open

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

Conversation

@koenw
Copy link
Copy Markdown
Contributor

@koenw koenw commented May 27, 2026

  • 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.
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