godotengine / godotengine/godot-docs

Meta: make `pyproject.toml` more useful when using dependency managers

Open
#11,807 1 comment 0 reactions 0 assignees View on GitHub
content:website enhancement
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

**Your Godot version:** 4.6

**Issue description:**

Currently, the tutorial for building the manual suggests using the `requirements.txt`. This misses a few things (such as dependency resolution, although we don't really need that) but mainly it means that no python version is actually being specified by the docs. I believe the versions specified in the `requirements.txt` need python 3.10 or above (at least that's what poetry told me).

This can easily be fixed by adding `[project]` metadata.

This has the added benefit of allowing tools such as poetry and uv to be used when creating venv's to build the docs.

**URL to the documentation page (if already existing):**

https://contributing.godotengine.org/en/latest/documentation/manual/building_the_manual.html

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.