Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cpython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kirill Smelkov
cpython
Commits
71337cb2
Commit
71337cb2
authored
Jan 14, 2014
by
Zachary Ware
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Issue #20255: Update the about and bugs pages.
parent
9774ce0c
Changes
3
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
28 additions
and
16 deletions
+28
-16
Doc/about.rst
Doc/about.rst
+5
-7
Doc/bugs.rst
Doc/bugs.rst
+21
-9
Misc/NEWS
Misc/NEWS
+2
-0
No files found.
Doc/about.rst
View file @
71337cb2
...
@@ -7,14 +7,15 @@ These documents are generated from `reStructuredText`_ sources by `Sphinx`_, a
...
@@ -7,14 +7,15 @@ These documents are generated from `reStructuredText`_ sources by `Sphinx`_, a
document processor specifically written for the Python documentation.
document processor specifically written for the Python documentation.
.. _reStructuredText: http://docutils.sf.net/rst.html
.. _reStructuredText: http://docutils.sf.net/rst.html
.. _Sphinx: http://sphinx
.pocoo
.org/
.. _Sphinx: http://sphinx
-doc
.org/
.. In the online version of these documents, you can submit comments and suggest
.. In the online version of these documents, you can submit comments and suggest
changes directly on the documentation pages.
changes directly on the documentation pages.
Development of the documentation and its toolchain takes place on the
Development of the documentation and its toolchain is an entirely volunteer
docs@python.org mailing list. We're always looking for volunteers wanting
effort, just like Python itself. If you want to contribute, please take a
to help with the docs, so feel free to send a mail there!
look at the :ref:`reporting-bugs` page for information on how to do so. New
volunteers are always welcome!
Many thanks go to:
Many thanks go to:
...
@@ -26,9 +27,6 @@ Many thanks go to:
...
@@ -26,9 +27,6 @@ Many thanks go to:
<http://effbot.org/zone/pyref.htm>`_ project from which Sphinx got many good
<http://effbot.org/zone/pyref.htm>`_ project from which Sphinx got many good
ideas.
ideas.
See :ref:`reporting-bugs` for information how to report bugs in this
documentation, or Python itself.
Contributors to the Python Documentation
Contributors to the Python Documentation
----------------------------------------
----------------------------------------
...
...
Doc/bugs.rst
View file @
71337cb2
...
@@ -13,15 +13,17 @@ Documentation bugs
...
@@ -13,15 +13,17 @@ Documentation bugs
==================
==================
If you find a bug in this documentation or would like to propose an improvement,
If you find a bug in this documentation or would like to propose an improvement,
please s
end an e-mail to docs@python.org describing the bug and where you found
please s
ubmit a bug report on the :ref:`tracker <using-the-tracker>`. If you
it. If you
have a suggestion how to fix it, include that as well.
have a suggestion how to fix it, include that as well.
docs@python.org is a mailing list run by volunteers; your request will be
If you're short on time, you can also email your bug report to docs@python.org.
noticed, even if it takes a while to be processed.
'docs@' is a mailing list run by volunteers; your request will be noticed,
though it may take a while to be processed.
Of course, if you want a more persistent record of your issue, you can use the
.. seealso::
issue tracker for documentation bugs as well.
`Documentation bugs`_ on the Python issue tracker
.. _using-the-tracker:
Using the Python issue tracker
Using the Python issue tracker
==============================
==============================
...
@@ -62,9 +64,6 @@ taken on the bug.
...
@@ -62,9 +64,6 @@ taken on the bug.
.. seealso::
.. seealso::
`Python Developer's Guide <http://docs.python.org/devguide/>`_
Detailed description of the issue workflow and developers tools.
`How to Report Bugs Effectively <http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_
`How to Report Bugs Effectively <http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_
Article which goes into some detail about how to create a useful bug report.
Article which goes into some detail about how to create a useful bug report.
This describes what kind of information is useful and why it is useful.
This describes what kind of information is useful and why it is useful.
...
@@ -73,3 +72,16 @@ taken on the bug.
...
@@ -73,3 +72,16 @@ taken on the bug.
Information about writing a good bug report. Some of this is specific to the
Information about writing a good bug report. Some of this is specific to the
Mozilla project, but describes general good practices.
Mozilla project, but describes general good practices.
Getting started contributing to Python yourself
===============================================
Beyond just reporting bugs that you find, you are also welcome to submit
patches to fix them. You can find more information on how to get started
patching Python in the `Python Developer's Guide`_. If you have questions,
the `core-mentorship mailing list`_ is a friendly place to get answers to
any and all questions pertaining to the process of fixing issues in Python.
.. _Documentation bugs: http://bugs.python.org/issue?@filter=status&@filter=components&components=4&status=1&@columns=id,activity,title,status&@sort=-activity
.. _Python Developer's Guide: http://docs.python.org/devguide/
.. _core-mentorship mailing list: https://mail.python.org/mailman/listinfo/core-mentorship/
Misc/NEWS
View file @
71337cb2
...
@@ -302,6 +302,8 @@ Tests
...
@@ -302,6 +302,8 @@ Tests
Documentation
Documentation
-------------
-------------
-
Issue
#
20255
:
Update
the
about
and
bugs
pages
.
-
Issue
#
20253
:
Fixed
a
typo
in
the
ipaddress
docs
that
advertised
an
-
Issue
#
20253
:
Fixed
a
typo
in
the
ipaddress
docs
that
advertised
an
illegal
attribute
name
.
Found
by
INADA
Naoki
.
illegal
attribute
name
.
Found
by
INADA
Naoki
.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment