search

NASA-IMPACT / veda-docs

Documentation for the VEDA Project
https://nasa-impact.github.io/veda-docs
Apache License 2.0
7 stars 6 forks source link

Add instructions for pushing to GitHub from the VEDA Hub #158

Open maxrjones opened 1 month ago

maxrjones commented 1 month ago

This PR adds a new section to Usage Examples called JupyterHub. It currently contains one markdown file How to push to GitHub from the VEDA JupyterHub but I think the new section would be helpful for other upcoming improvements (e.g., additional IDEs). While there's some redundancy with the 2i2c docs, I think the 2i2c docs offer cover background and reasons for things being done a certain way (which is useful for their audience), whereas these how-to guides would provide the minimal required explanation for solving a user's problem.

github-actions[bot] commented 1 month ago

PR Preview Action v1.4.7 :---: :rocket: Deployed preview to https://NASA-IMPACT.github.io/veda-docs/pr-preview/pr-158/ on branch gh-pages at 2024-08-15 20:58 UTC

maxrjones commented 4 weeks ago

Thanks for the review @jsignell! @wildintellect mentioned that this setup may still be confusing to users, so I'm going to try out recording a quick video explanation (hopefully tomorrow). So, I'll hold off on merging this for a short while and may ping you for another review.

that error does seem likely relating to an existing setup. I can add a warning and perhaps we should also include a section in the JupyterHub section of the docs on where users can go to reach out for help. Is the IMPACT slack where that help would happen?

wildintellect commented 4 weeks ago

Step 1. Clarify that an Org admin has to setup the initial permissions. Step 2.

Second, you need to authorize the app on the Hub. This needs to be done once every 8 hours. Does every user need to do this? So basically it's once per working day? Can we include gh-scoped-creds.ipynb in the docs repo, so that users just need to open it and run it? (we already checkout the docs in Pangeo workspaces)

The whole thing feels reverse order for actual user usage.

  1. Remember to clone your repos with https, NOTE: github token is the alternative to this method
  2. Authorize once per day (Every 8 hours) <- I wonder if we could make a widget or if the jupyter github extension incorporates this
  3. First time Config for Repos/Organizations (maybe mention at top and link to bottom?