# How was the Hail site created?

**URL:** <https://discuss.hail.is/t/how-was-the-hail-site-created/3301>\
**Category:** Meta\
**Created:** [March 31, 2023, 12:46pm UTC](https://discuss.hail.is/t/how-was-the-hail-site-created/3301 "2023-03-31T12:46:59Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![mennowitteveen](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.hail.is/mennowitteveen/32/938_2.png) [@mennowitteveen](https://discuss.hail.is/u/mennowitteveen)\
**Post date:** [March 31, 2023, 12:47pm UTC](https://discuss.hail.is/t/how-was-the-hail-site-created/3301/1 "2023-03-31T12:47:00Z")

</div>

Hi There,

I was just curious, how was the Hail site / website created?

I think the documentation site looks very nice and seems to be generated from Jupyter notebooks somehow. Also it seems like it is well integrated with the Github.

Sorry if I missed it in the FAQ or related.

---

<div class="post-metadata">

**Author:** ![tpoterba](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.hail.is/tpoterba/32/61_2.png) [@tpoterba](https://discuss.hail.is/u/tpoterba)\
**Post date:** [March 31, 2023, 2:27pm UTC](https://discuss.hail.is/t/how-was-the-hail-site-created/3301/2 "2023-03-31T14:27:26Z")

</div>

The site is indeed generated from files in the repository on GitHub. The main site (www.hail.is) is written in templated html / javascript – nothing super fancy – and the docs are generated with [Sphinx](https://www.sphinx-doc.org/en/master/), which allows us to generate documentation from inline docstrings and supporting ReStructuredText files. The tutorials are created by a Sphinx extension that runs jupyter notebooks (see [here](https://github.com/hail-is/hail/tree/b972438623944fecd8c0c70378721143d354eeb3/hail/python/hail/docs/tutorials) in the repo) and saving the output as html.