To add the FAQ to the Python documentation set:

1) Create a symlink from Doc/faq to this directory.

2) Make the following change to contents.rst:

Index: contents.rst
===================================================================
--- contents.rst	(revision 75033)
+++ contents.rst	(working copy)
@@ -15,6 +15,7 @@
    install/index.rst
    documenting/index.rst
    howto/index.rst
+   faq/index.rst
    glossary.rst
 
    about.rst

3) (optional) To add the FAQs to the top-level table of contents,
   apply the following patch.

Index: tools/sphinxext/indexcontent.html
===================================================================
--- tools/sphinxext/indexcontent.html	(revision 75033)
+++ tools/sphinxext/indexcontent.html	(working copy)
@@ -26,6 +26,8 @@
          <span class="linkdescr">sharing modules with others</span></p>
       <p class="biglink"><a class="biglink" href="{{ pathto("documenting/index") }}">Documenting Python</a><br/>
          <span class="linkdescr">guide for documentation authors</span></p>
+      <p class="biglink"><a class="biglink" href="{{ pathto("faq/index") }}">FAQs</a><br/>
+         <span class="linkdescr">frequently asked questions</span></p>
     </td></tr>
   </table>