[issue37799] Renaming Doc/reference/ to Doc/language/
New submission from Géry <gery.ogam@gmail.com>: The page https://docs.python.org/3/ lists these two parts: - Library Reference - Language Reference So both parts are "references". However in the cpython GitHub repository, the Doc/ directory contains these two directories: - library/ - reference/ So to be consistent, shouldn't we rename the Doc/reference/ directory to Doc/language/? ---------- assignee: docs@python components: Documentation messages: 349280 nosy: docs@python, maggyero priority: normal severity: normal status: open title: Renaming Doc/reference/ to Doc/language/ versions: Python 3.7 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37799> _______________________________________
Change by Géry <gery.ogam@gmail.com>: ---------- type: -> enhancement _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37799> _______________________________________
Emmanuel Arias <emmanuelarias30@gmail.com> added the comment: Hello maggyero, I thinks that could be a good improve. But this structure is used on since old cpython versions, so I don't know if it will be a necessary change. But, if you don't receive some feedback from here, you can propose a PR, maybe other core dev could review it and tell you their opinion :-) ---------- nosy: +eamanu _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37799> _______________________________________
Mariatta <mariatta@python.org> added the comment: The change is not worth doing for several reasons: - renaming filename/directory breaks git history on GitHub web UI. The history can still be viewed if you use the command line e.g. git log --follow. - other pages like stack overflow or blog posts have linked to the /reference for ages. We'll be breaking links. We might be able to set up redirect to the new path, but the effort is not worth the gain IMO. There is very little to be gained compared to all the pitfalls. So I'm closing this issue. Thanks. ---------- nosy: +Mariatta priority: normal -> low resolution: -> rejected stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue37799> _______________________________________
participants (3)
-
Emmanuel Arias -
Géry
-
Mariatta