[issue37799] Renaming Doc/reference/ to Doc/language/

[Mariatta]

Mariatta  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37799] Renaming Doc/reference/ to Doc/language/

[Emmanuel Arias]

Emmanuel Arias  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37799] Renaming Doc/reference/ to Doc/language/

[Géry]

New submission from Géry :

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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37799] Renaming Doc/reference/ to Doc/language/

[Géry]

Change by Géry :


--
type:  -> enhancement

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com