diff -r c8581129d2c4 docquality.rst --- a/docquality.rst Mon Jun 17 12:19:40 2013 -0700 +++ b/docquality.rst Thu Jul 04 19:38:21 2013 +0800 @@ -19,10 +19,8 @@ http://docs.python.org/dev/. The in-development and most recent 2.x and 3.x maintenance :ref:`branches ` are rebuilt once per day. -If you would like a technical documentation style guide, the `Apple -Publications Style Guide -`_ -is recommended. +If you would like a technical documentation style guide, the +:ref:`Apple Style Guide ` is recommended. If you care to get more involved with documentation, you may also consider subscribing to the diff -r c8581129d2c4 documenting.rst --- a/documenting.rst Mon Jun 17 12:19:40 2013 -0700 +++ b/documenting.rst Thu Jul 04 19:38:21 2013 +0800 @@ -61,7 +61,9 @@ Style guide =========== -The Python documentation should follow the `Apple Publications Style Guide`_ +.. _apple-style-guide: + +The Python documentation should follow the `Apple Style Guide` (available `online`_ or as a `PDF`_) wherever possible. This particular style guide was selected mostly because it seems reasonable and is easy to get online. @@ -69,6 +71,9 @@ differently in Python documentation will be discussed in this document. +.. _online: https://help.apple.com/asg/mac/2013/ +.. _PDF: https://help.apple.com/asg/mac/2013/ASG_2013.pdf + Use of whitespace ----------------- @@ -266,9 +271,6 @@ making false assumptions about the language ("I was surprised by ..."). -.. _Apple Publications Style Guide: http://developer.apple.com/mac/library/documentation/UserExperience/Conceptual/APStyleGuide/APSG_2009.pdf - - reStructuredText Primer =======================