NumPy Documentation Gallery structure
Hello Melissa and Ralf , I was just wondering if we haven't had much discussion on the structuring of tutorials , while we have had some discussion on Explanations . I have been analysing the Tutorials of some other communities too , say Matplotlib : they have basically structured the tutorials page like a Gallery where examples have been arranged in the order of experience level . Link to Matplotlib tutorials : https://matplotlib.org/3.2.2/tutorials/index.html Here is SunPy Documentation. They have tried to structure their How-TO examples in the same way like a Gallery . Link to SunPy Gallery Examples : https://docs.sunpy.org/en/v2.0.1/generated/gallery/index.html# Please have a Look , maybe we can also get some new ideas for our Documentation . I think it will help us to structure the Tutorials page of NumPy too . Thanks , Mrinal Tyagi
Hi Matti , Yup , Matplotlib and SunPy are using Sphinx Gallery 🙂 , I am asking , could we are also have some discussion around such structure maybe modifying it in a way more suited to NumPy community ? What do you think? Thanks , Mrinal On Wed, 8 Jul, 2020, 12:09 pm Matti Picus, <matti.picus@gmail.com> wrote:
I think those projects use https://github.com/sphinx-gallery/sphinx-gallery to do the layout
Matti
On 7/8/20 9:31 AM, Saber Tooth wrote:
Hello Melissa and Ralf ,
I was just wondering if we haven't had much discussion on the structuring of tutorials , while we have had some discussion on Explanations .
I have been analysing the Tutorials of some other communities too , say Matplotlib : they have basically structured the tutorials page like a Gallery where examples have been arranged in the order of experience level . Link to Matplotlib tutorials : https://matplotlib.org/3.2.2/tutorials/index.html
Here is SunPy Documentation. They have tried to structure their How-TO examples in the same way like a Gallery . Link to SunPy Gallery Examples : https://docs.sunpy.org/en/v2.0.1/generated/gallery/index.html#
Please have a Look , maybe we can also get some new ideas for our Documentation . I think it will help us to structure the Tutorials page of NumPy too .
Thanks , Mrinal Tyagi -- You received this message because you are subscribed to the Google Groups "numpy-scipy-gsod" group. To unsubscribe from this group and stop receiving emails from it, send an email to numpy-scipy-gsod+unsubscribe@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/numpy-scipy-gsod/CAAq%2BcUHVfs-u%2B2cAwXZj... <https://groups.google.com/d/msgid/numpy-scipy-gsod/CAAq%2BcUHVfs-u%2B2cAwXZjwvnd6VOPBvmM1BMxJtPmfa6oHZz0nA%40mail.gmail.com?utm_medium=email&utm_source=footer> .
participants (3)
-
Kevin Sheppard
-
Matti Picus
-
Saber Tooth