# Restructure docs for easy access to tutorials

**URL:** <https://discourse.pymc.io/t/restructure-docs-for-easy-access-to-tutorials/2377>\
**Category:** Development\
**Tags:** doc\
**Created:** [December 13, 2018, 1:30pm UTC](https://discourse.pymc.io/t/restructure-docs-for-easy-access-to-tutorials/2377 "2018-12-13T13:30:54Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![ashwinvis](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.pymc.io/ashwinvis/32/1345_2.png) [@ashwinvis](https://discourse.pymc.io/u/ashwinvis)\
**Post date:** [December 13, 2018, 1:30pm UTC](https://discourse.pymc.io/t/restructure-docs-for-easy-access-to-tutorials/2377/1 "2018-12-13T13:30:54Z")

</div>

My 2 cents from my experience after going through many pages of documentations, notebooks, videos, and stack overflow threads. Please restructure the landing page.

I wish you would separate the how-to into a separate page called tutorials, similar to other projects have done: [http://docs.astropy.org/en/stable/](http://docs.astropy.org/en/stable/), [https://matplotlib.org/](https://matplotlib.org/). Here are some of my thoughts on how it is structured now:

- Quickstart -\> short and nice, but no follow up links to read more.
- API - this page is OK, in my opinion.
- Examples -\> This hides the “tutorials” or HOWTOs somewhere in the middle.
- Learn - confusing title, as I was expecting to see tutorials. Could be renamed to “Resources” or similar

If needed I can open a issue.

---

<div class="post-metadata">

**Author:** ![junpenglao](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.pymc.io/junpenglao/32/8_2.png) [@junpenglao](https://discourse.pymc.io/u/junpenglao)\
**Post date:** [December 13, 2018, 7:35pm UTC](https://discourse.pymc.io/t/restructure-docs-for-easy-access-to-tutorials/2377/2 "2018-12-13T19:35:24Z")

</div>

Thanks for your suggestions! We are in the process of restructuring our doc so please open an issue (or a PR😁)

---

<div class="post-metadata">

**Author:** ![ashwinvis](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.pymc.io/ashwinvis/32/1345_2.png) [@ashwinvis](https://discourse.pymc.io/u/ashwinvis)\
**Post date:** [December 14, 2018, 8:44pm UTC](https://discourse.pymc.io/t/restructure-docs-for-easy-access-to-tutorials/2377/3 "2018-12-14T20:44:10Z")

</div>

Thanks to all the devs for this awesome package. I have opened an issue here:

> <https://github.com/pymc-devs/pymc3/issues/3301>