Tutorials on stdlib modules about stdlib-docs HOT 3 OPEN

@awvwgk Thank you for opening all these issues. Unfortunately I am currently quite busy. I hope to come back on these by the end of the week.

from stdlib-docs.

@awvwgk I just saw that you put the stuff on Numpy files in the section how-to, while I would put intuitively such a description in the section tutorial. Why did you do this choice (note: it is fine for me as is, but based on your comment on this thread, I was expecting to find it here)

from stdlib-docs.

You can think of the tutorials as a general introduction to Fortran while also using stdlib. For the tutorials we are looking for a somewhat complete example application, which is build step by step in the course of a tutorial. This allows to explore several features of one or more stdlib modules.

For fpm we have a small command line application with some stdlib functions and declares dependencies on various fpm projects, while we are building a library, adding a CLI and finally also unit testing. Similarly, one could think about analyzing a data set using the statistics module while navigating through different statistical measures and their practical relevance.

One of the nice aspects about writing a tutorial is that it shows you what we can't do with stdlib.

For the how to guides I'm taking a specific task and show how it is done with stdlib. This is much more problem oriented way of making stdlib's features accessible, however it is only useful if you know exactly what you want to do with stdlib.

from stdlib-docs.