Create a Community Showcase Handbook

[jmunroe]

Developing content for the Community Showcase Handbook and will be using the documentation from the Hub Service as a starting point.

The aim for the new Community Showcase Handbook is to develop a beginner-friendly, tutorial/examples-driven guide to onboard Hub Champions and their users, whereas the existing Hub Service Guide will serve as reference material for intermediate/advanced users.

[jnywong]

I will be developing content for the Community Showcase Handbook and will be using the documentation from the Hub Service as a starting point, which I have ported across in PR https://github.com/2i2c-org/community-showcase/pull/43.

My aim for the new Community Showcase Handbook is to develop a beginner-friendly, tutorial/examples-driven guide to onboard Hub Champions and their users, whereas the existing Hub Service Guide will serve as reference material for intermediate/advanced users.

[jmunroe]

I am setting this issue to track @jnywong work in developing the content behind the Community Showcase Handbook.

Some topics that I could imagine may eventually be covered in such a Handbook include

• How to manage access to a 2i2c hub?
• How to onboard a new user of a 2i2c hub?
• How to use gh_scoped_creds to enable easy and secure push access to GitHub repos?
• How to use nbgitpuller?
• How to customize landing pages?
• How to use Jupyter's internal messaging system? (Pop ups in Lab after logging in.)
• How to measure resource usage versus time? Prometheus, Grafana, notebooks that ingest billing and usage data?
• How to manage software image(s) for a 2i2c hub?
• How to get involved and contribute to open source? Upstream Doula.
• How to use and customize the Linux desktop offering on a 2i2c hub?
• How and why to use a "database sidecar"?
• How to use Dask Gateway?
• How to use GPU for ML?
• What's the hybrid (HPC + Cloud + Local) future look like?

[jmunroe]

Updated top-comment to reflect @jnywong current plan.