Skip to content

uv lock and uv sync expected behaviour is poorly documented and not clearly inferable from the "locking and syncing" docs page #18029

@fkiraly

Description

@fkiraly

Summary

To the ordinary reader of the docs, the expected behaviour of uv lock - and by extension, first calls of other commands such as uv sync - cannot be gleaned from the primary documentation page for lock and sync in a clear way..

The relevant documentation pages are these, I reckon:
"locking and syncing" - https://docs.astral.sh/uv/concepts/projects/sync/
"resolution" - https://docs.astral.sh/uv/concepts/resolution/

What is entirely unclear to an informed but external reader of the sync page is that the "universal resolution" described on the page resolution is always used; the latter also appears only in a very late paragraph. There is no link to "resolution", no use of the word, or no other clear way to guess the link either, from the sync page.

Example

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions