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>