joss-paper: Build tutorials not described

[PetrKryslUCSD]

The readme does not describe how to get the tutorial notebooks opened from a cloned repository. In particular, when the repository is cloned, there are no notebooks. They need to be built. The build step is not documented. It appears to be activate/instantiate/build.
Then one can open a notebook with IJulia.notebook().

[fverdugo]

Related to openjournals/joss-reviews#2520

[fverdugo]

@PetrKryslUCSD The steps to clone, build and open the notebooks of the Gridap tutorials are explained in the documentation pages of the tutorials repository https://gridap.github.io/Tutorials/stable/

In the read-me file of https://github.com/gridap/Tutorials there is a link to the documentation pages. Do you believe this is not enough?

[PetrKryslUCSD]

My comment was based on the order in which the user would proceed. If I start with the readme, follow the link to the stable version of the tutorials, and click on the first tutorial I can see how to run it in the mybinder, but I don't know how to run it on my own machine. So I go back to the readme.

Honestly, I missed the description that is below the list of tutorials. My bad. But I think it points to a possible reorganization where the documentation of the tutorials starts with instructions on how to run them, and then follows the list of tutorials.

Just a suggestion.

[fverdugo]

Perhaps the problem is that the instructions on how to build the notebooks are not in the section called How to start.

https://gridap.github.io/Tutorials/stable/#How-to-start-1

I'll try to fix this.

[fverdugo]

Hi @PetrKryslUCSD

I have rewritten the confusing part. I hope that now it is better:

https://gridap.github.io/Tutorials/v0.12/

If you are happy with the changes, please close the issue.

Thanks!