# Documentation for PyFR **URL:** \ **Category:** General\ **Created:** [24 September 2020 14:45 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298 "2020-09-24T14:45:03Z")\ **Posts on this page:** 8\ **Page:** 1
**Author:** ![Gavin\_Wiggins](https://avatars.discourse-cdn.com/v4/letter/g/cdc98d/32.png) [@Gavin\_Wiggins](https://pyfr.discourse.group/u/Gavin_Wiggins)\ **Post date:** [24 September 2020 14:45 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298/1 "2020-09-24T14:45:03Z")
In the [PyFR GitHub repository](https://github.com/PyFR/PyFR) there is a “doc” directory. It looks like this directory is for building the documentation with Sphinx. But where is the documentation hosted? Is it just the main PyFR website at [http://www.pyfr.org](http://www.pyfr.org)? ---
**Author:** ![p.vincent](https://yyz2.discourse-cdn.com/free1/user_avatar/pyfr.discourse.group/p.vincent/32/225_2.png) [@p.vincent](https://pyfr.discourse.group/u/p.vincent)\ **Post date:** [24 September 2020 15:38 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298/2 "2020-09-24T15:38:15Z")
Hi Gavin, Yes, the html version of the docs are hosted on the PyFR website. Peter ---
**Author:** ![Gavin\_Wiggins](https://avatars.discourse-cdn.com/v4/letter/g/cdc98d/32.png) [@Gavin\_Wiggins](https://pyfr.discourse.group/u/Gavin_Wiggins)\ **Post date:** [24 September 2020 18:44 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298/3 "2020-09-24T18:44:23Z")
I’m trying to build the Sphinx documentation from within the `doc` folder using `make html` but I get the following error: Could not import extension tikz (exception: cannot import name ‘Directive’ from ‘sphinx.util.compat’ (/Users/gavinw/Desktop/GitHub/wigging/PyFR/venv/lib/python3.7/site-packages/sphinx/util/compat.py)) make: \*\*\* [html] Error 2 Any suggestions on how to build the docs locally? ---
**Author:** ![Gavin\_Wiggins](https://avatars.discourse-cdn.com/v4/letter/g/cdc98d/32.png) [@Gavin\_Wiggins](https://pyfr.discourse.group/u/Gavin_Wiggins)\ **Post date:** [24 September 2020 19:04 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298/4 "2020-09-24T19:04:50Z")
Using ‘sphinxcontrib.tikz’ instead of ‘tikz’ fixes the problem and I’m able to build the site. Although some warnings appear about deprecated highlighting. The built Sphinx site looks nothing like your website at [pyfr.org](http://pyfr.org) (see attached screenshot). You must be doing some post-Sphinx steps and CSS after the build. ![screenshot.png](https://global.discourse-cdn.com/free1/uploads/pyfr/original/1X/a3b250ed63bed397b19598a5b04c70134356a3d1.png) ---
**Author:** ![Gavin\_Wiggins](https://avatars.discourse-cdn.com/v4/letter/g/cdc98d/32.png) [@Gavin\_Wiggins](https://pyfr.discourse.group/u/Gavin_Wiggins)\ **Post date:** [24 September 2020 19:13 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298/5 "2020-09-24T19:13:09Z")
I highly recommend using [Read the Docs](https://readthedocs.org) for the PyFR documentation. It will make it easier for others (including myself) to contribute to the documentation. It can be setup to automatically update the documentation website from the GitHub repo when new changes are pushed. I did this for one of my personal projects ([https://chemics.readthedocs.io](https://chemics.readthedocs.io)) and it works well. ---
**Author:** ![p.vincent](https://yyz2.discourse-cdn.com/free1/user_avatar/pyfr.discourse.group/p.vincent/32/225_2.png) [@p.vincent](https://pyfr.discourse.group/u/p.vincent)\ **Post date:** [26 September 2020 19:40 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298/6 "2020-09-26T19:40:40Z")
Hi Gavin, Yes, on each release I compile the docs and then drop the /html folder into the website, that has code to automatically integrate it (and apply styles that match the rest of the website). The content is identical, however. Thanks Peter ---
**Author:** ![p.vincent](https://yyz2.discourse-cdn.com/free1/user_avatar/pyfr.discourse.group/p.vincent/32/225_2.png) [@p.vincent](https://pyfr.discourse.group/u/p.vincent)\ **Post date:** [26 September 2020 19:45 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298/7 "2020-09-26T19:45:43Z")
Hi Gavin, Thanks for the suggestions. Our process around the docs is about 8 years old, so it may well benefit from a bit of an overhaul. I’ll take a look at Read the Docs and possible Github based workflows and get back to you (it may take me a week or so due to the start of term). Maybe we can then have a call to discuss options and get your feedback? In the interim, would you be able to submit a new PR that simply changes the format of the README to .md and also fixes the typo in the .ini file for the incompressible cylinder example case? We can then get those parts in straight away. Thanks Peter ---
**Author:** ![Gavin\_Wiggins](https://avatars.discourse-cdn.com/v4/letter/g/cdc98d/32.png) [@Gavin\_Wiggins](https://pyfr.discourse.group/u/Gavin_Wiggins)\ **Post date:** [27 September 2020 14:59 UTC](https://pyfr.discourse.group/t/documentation-for-pyfr/298/8 "2020-09-27T14:59:28Z")
I submitted Pull Requests for the README and the typo in the ini file. I also started a new docs build using the latest version of Sphinx. I’ll share that as a draft Pull Request once it’s ready.