search

2i2c-org / docs

Documentation for 2i2c community JupyterHubs.
https://docs.2i2c.org
9 stars 17 forks source link

Refactor documentation structure and add community docs #163

Closed choldgraf closed 2 years ago

choldgraf commented 2 years ago

This is a follow-up to a suggestion that @colliand made around community resources and guidance. As a part of doing that I didn't find a natural place for this information, so did a bit of re-working in the process. Here are the two changes:

  1. Re-works the top-level structure of the docs so that there's a different "user persona" for each top-level section (users, administrators, leaders, and community reps) (closes https://github.com/2i2c-org/docs/issues/160)
  2. Splits up the "data" section into a few sub-sections to be easier to quickly discover in the sidebar.
  3. Adds some resources on community organizing and leadership (cc @colliand and closes https://github.com/2i2c-org/docs/issues/159)

My hope is that the refactor makes it easier to quickly find the information somebody is looking for, and also makes it more natural for us to know where to add new documentation when we want to create it.

choldgraf commented 2 years ago

woo - OK great, let's merge this in so that it doesn't create more merge conflicts and iterate from there. Thanks for the 👀