Hello, Mrinal Yes, we are having our meeting on monday (more information in a message still to come). Right now, our idea of what tutorials and how-tos are comes from Daniele Procida [1] (detailed in NEP 44 [2]). However, I believe the discussion around exactly what we will cover or try to achieve in each kind of document is not finished. In fact, we are still learning how to organize this. Feel free to add a topic in the meeting notes for the Documentation Meeting [3] so we can discuss this on monday. Cheers, Melissa [1] https://documentation.divio.com/ [2] https://numpy.org/neps/nep-0044-restructuring-numpy-docs.html [3] https://hackmd.io/oB_boakvRqKR-_2jRV-Qjg On Thu, Jul 16, 2020 at 5:14 AM Saber Tooth <sabertooth2022@gmail.com> wrote:
Hello Melissa ,
Are we having our Docs meeting on 20th July ? If yes , then could we have some discussion around the structure of tutorials ,how-to sections . I wanted to discuss how we are planning to distinguish between the two , should the How-to be straightforward solutions like here <https://matplotlib.org/3.2.2/gallery/lines_bars_and_markers/bar_stacked.html...> or something else . Tutorials should be structured as in here <https://matplotlib.org/3.2.2/tutorials/introductory/usage.html#sphx-glr-tuto...> or something else .
The general belief is when we hear the word "How to" is that we are greeted to just the solution of the problem like above , while when we hear Tutorials we are greeted to Detailed solutions with explanations for most of the steps .
Thanks , Mrinal