This is how my documentation will look. I make a title by putting equals signs underneath ================================================= I can then write whatever else I want in other places. lets the toctree know that I would like to add another file usage .rst which will act as a new page for the docs and will appear in the contents page! Make newpage2.rst and add newpage2 to the bottom of the toctree and make html to see results.