New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
update :class:str
references to link to the str type section
#60409
Comments
3.3 added a dedicated section to the docs for the str type. However, references to :class:`str` still link to the documentation of the built-in function str(). This issue is to update references to the str class to point to the new section on the str type. We could use :ref:`str <textseq>`, but it would be nice to have a solution that makes "str" have the code-style font instead of italics. |
I'm not sure if Sphinx would allow it, but it would be nice if references to the function str() could link to the built-in function documentation, and references to the class str could link to the section on the str type. |
The documentation seems to take a similar approach with dict: http://docs.python.org/dev/library/stdtypes.html#dict |
If :class:`str` and :func:`str` point respectively to stdtypes.rst and functions.rst once a class directive is added to stdtypes.rst, then we can do that. We might than need to update a few links to use :class: instead of :func:, and possibly use :ref:`textseq` where appropriate. |
Adding a class directive for str is tracked in bpo-16209. |
I agree. I would suggest starting small by adding a stub class entry above the string methods. The class constructor could link to the built-in function str() for its definition. |
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
bugs.python.org fields:
The text was updated successfully, but these errors were encountered: