spack-tutorial
spack-tutorial copied to clipboard
Package Creation tutorial has too much beginner stuff
The Package Creation tutorial has a long section on setting SPACK_ROOT, PATH, and EDITOR, sourcing the setup script, etc. At this point in the tutorial, we've done this a million times, no need to specify this again. In fact, things like EDITOR should be moved to earlier points in the tutorial.
I agree too much beginner stuff left in it BUT I think we should at least have a pointer to that kind of information to cover the case of someone starting with that section of the tutorial.
Is there a way in sphinx to have a collapsible section? That might be perfect for this
Is there a way in sphinx to have a collapsible section? That might be perfect for this
Great idea! And there is a collapse
feature: https://sphinx-toolbox.readthedocs.io/en/stable/extensions/collapse.html
If we do collapse it for beginner, we should collapse it for all tutorials. Or only in the first tutorial where we need it.
This no longer seems to be an issue.