search

nasa-fornax / fornax-documentation

Documentation for Fornax Science Console.
https://nasa-fornax.github.io/fornax-demo-notebooks/#user-documentation
BSD 3-Clause "New" or "Revised" License
2 stars 3 forks source link

The documentation needs to include how to get the notebook tutorials into the Fornax Science Console #36

Open vandesai1 opened 3 months ago

vandesai1 commented 3 months ago

Currently the Examples and Tutorials section of the documentation re-creates the outline of the notebook tutorials, which are rendered on the same page as the documentation. Instead, this section should just link to the Fornax Tutorials section.

There needs to be some indication of how to connect these tutorials to the Fornax Science Console. For example, if I want to use the Forced Photometry notebook in the Fornax Science Console, do I just need to download the tutorial from github and then upload it into the Console? And which files do I need?

bsipocz commented 2 months ago

See relevant discussion in this issue: https://github.com/nasa-fornax/fornax-images/issues/4#issuecomment-2269959335

jkrick commented 1 month ago

ok, so now we need documentation on how to use the cloned repo that shows up in /opt/notebooks. questions I just sent to the helpdesk include:

How do we actually see those notebooks? I can’t figure out how to get them to show up in the left file folder listing, and therefore can’t open them as notebooks.

Will users be able to overwrite these files or are they read only? What is the best practice for users to play with these notebooks? ie., should we suggest copying them to a different directory, or cloning them again if a user wants to open a branch and make some changes?

bsipocz commented 1 month ago

cc @zoghbi-a for these questions.