Update Jupyter documentation to explain relative paths

[jarosenb]

Encourage users to use relative paths in Jupyter notebooks, with an explanation of the concept and a worked example with some common patterns.

[silviamazzoni]

You can find this (and more) in the OpenSees-on-DesignSafe Training Documentation:
https://designsafe-ci.github.io/training-OpenSees-on-DesignSafe/Docs_MD/Paths_Overview.html

[wesleyboar]

@mesteva,

Are you okay with this change here?

I think that page is not an appropriate location for such technical information.

And @silviamazzoni says that technical information available in training docs that DS User Guide links out too.

_{I've also pinged @mesteva internally, and will carry over her answer if that is where she replies.}

[silviamazzoni]

Also, whether you use relative or absolute paths depends on your task.

[wesleyboar]

I got answers.

• @jarosenb, please migrate your improvements / technical information to tools/jupyterhub/#publishing-notebooks.
• @jarosenb and @silviamazzoni, please consider whether @silviamazzoni's external-but-related Path documentation should be linked to from tools/jupyterhub/#publishing-notebooks.
  • Moved to #224.
• After that update, @mesteva will have me update curating/bestpractices/#jupyter-notebooks accordingly to point to that improved content.

[silviamazzoni]

@wesleyboar ,
in . Here is an example of a published notebook that writes files to user directories. you have a link to the data depot, i would recommend you add also give the option to open the notebook directly in Jupyter Hub.

[wesleyboar]

Thanks. Merged.

I will add M.E.'s change in a follow-up PR.

I will consider S.M.'s suggestions for follow-up improvements.

[wesleyboar]

@silviamazzoni, I've moved your idea to #224.¹

Footnotes

1. Autumn is busy time at TACC, and DS work is currently slowed. ↩