Skip to content

Unclear sphinx pin in pyproject.toml #583

@rossbar

Description

@rossbar

Describe the bug

The pyproject.toml contains the following pin:

"sphinx~=4.0", # Force Sphinx to be the latest version

From the comment, it is unclear whether this pin to the sphinx 4.X series is intentional or not, since "latest" == 5.X.

If the pin to sphinx 4.X is intentional, an update to the comment would be sufficient. FWIW the pin does seem to be important in that we have projects that build with sphinx 4.X but not 5.X, though I suspect the real problem is transitive dependencies (e.g. docutils). See numpy/numpy-tutorials#136.

Reproduce the bug

N/A

List your environment

N/A

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions