Skip to content

Documentation link can go to latest published version, not latest non-pre-release version #894

Closed
@carols10cents

Description

@carols10cents

Which can be confusing.

Example:

Now, we could switch to storing documentation URL as a property of the version rather than the crate, but I don't think what this crate is doing is what people normally do! If you're using docs.rs, for example, the documentation for a version won't exist until after you publish and docs.rs has a chance to build it, so the documentation link would 404 for a bit after publishing if you specified the version. Updating the version in another spot in your Cargo.toml would also be annoying.

For people hosting their own docs, I don't even know if it's common to publish beneath a version path and keep old docs around, or if people are always overwriting to the same spot. This seems like a tooling issue that perhaps cargo could help with.

Or there may be other solutions to this, or other problems associated with these solutions that I haven't thought of yet. Mostly I just want to track this for discussion.

Metadata

Metadata

Assignees

No one assigned

    Labels

    C-bug 🐞Category: unintended, undesired behavior

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions