# Migrating ParaView Guide to Sphinx / ReadTheDocs

**URL:** <https://discourse.paraview.org/t/migrating-paraview-guide-to-sphinx-readthedocs/4695>\
**Category:** Development\
**Tags:** proposal\
**Created:** [June 26, 2020, 2:08pm UTC](https://discourse.paraview.org/t/migrating-paraview-guide-to-sphinx-readthedocs/4695 "2020-06-26T14:08:05Z")\
**Posts on this page:** 3\
**Page:** 2

<div class="post-metadata">

**Author:** ![danlipsa](https://discourse.paraview.org/user_avatar/discourse.paraview.org/danlipsa/32/1563_2.png) [@danlipsa](https://discourse.paraview.org/u/danlipsa)\
**Post date:** [July 13, 2020, 4:11pm UTC](https://discourse.paraview.org/t/migrating-paraview-guide-to-sphinx-readthedocs/4695/21 "2020-07-13T16:11:18Z")

</div>

This looks great!

Do we want to specify in the documentation what version of ParaView is covered? Do we offer the guide for older versions of ParaView?

---

<div class="post-metadata">

**Author:** ![danlipsa](https://discourse.paraview.org/user_avatar/discourse.paraview.org/danlipsa/32/1563_2.png) [@danlipsa](https://discourse.paraview.org/u/danlipsa)\
**Post date:** [July 13, 2020, 4:14pm UTC](https://discourse.paraview.org/t/migrating-paraview-guide-to-sphinx-readthedocs/4695/22 "2020-07-13T16:14:00Z")

</div>

Oh, I see that the versions are already there.

---

<div class="post-metadata">

**Author:** ![llionevans](https://discourse.paraview.org/letter_avatar_proxy/v4/letter/l/b9e5f3/32.png) [@llionevans](https://discourse.paraview.org/u/llionevans)\
**Post date:** [July 14, 2020, 9:17am UTC](https://discourse.paraview.org/t/migrating-paraview-guide-to-sphinx-readthedocs/4695/23 "2020-07-14T09:17:27Z")

</div>

We’ve recently started using sphinx and readthedocs with a project we’ve got going on at the moment. Given the conversation above, a few things that are worth mentioning:

1. You can package the built docs with your software binaries, so the ‘getting started guide’ (or whatever else) could be available locally without an internet connection. It would just open in a browser rather than pdf reader. If you really wanted, you could embed a browser in the ParaView GUI, so that the user never leaves that environment.
2. Because you’re using version control for your docs, you can point particular versions of your software to a particular version of the docs.
3. sphinx and reStructuredText are the backbone of your docs. readthedocs is just the webhost, if you don’t like the advertising or want to use your own domain name you can host them on your own site. But you’d probably want to set up a webhook so that the source is pulled and recompiled for each new commit.

This might be stating the obvious, but hopefully some help.

[Previous page](https://discourse.paraview.org/t/migrating-paraview-guide-to-sphinx-readthedocs/4695.md?page=1)
