Merge pull request #39 from ryanlovett/toc

Move TOC into myst.yml

connector/general/previous-connectors.md

@@ -1,4 +1,20 @@
-# Previous Connector Courses
+---
+title: Previous Connector Courses
+abbreviations:
+  CIVENG: Civil Engineering
+  COGSCI: Cognitive Science
+  COMPSCI: Computer Science
+  DEMOG: Demography
+  EPS: Earth & Planetary Science
+  ESPM: Environmental Science, Policy, and Management
+  GEOG: Geography
+  HIST: History
+  INFO: School of Information
+  MCB: Moleculrar and Cell Biology
+  POLSCI: Political Science
+  SOCIOL: Sociology
+  STAT: Statistics
+---
 
 The links below point either to a PDF syllabus or to a course website that contains the syllabus.
 

connector/instructor/communication-channels.md

@@ -1,18 +1,7 @@
-# Communication Channels
+---
+title: Communication Channels
+---
 
-<!--
-
-### Piazza
-
-We have set up a [Piazza site](https://piazza.com/berkeley/other/cs97) for any dicussion related to connectors. This page is for connector instructors and connector assistants \(CAs\) to post questions and concerns they may have. CDSS staff members are regularly monitoring this page and will respond promptly. We are using Piazza instead of email so that communication is open and information is not confined to a private email thread. You also do not have to worry about figuring out who to email. Just post on Piazza and the right person will get back to you!
-
--->
-
-### Biweekly Instructor Meetings
+## Biweekly Instructor Meetings
 
 We will be holding connector instructor meetings every two weeks. These meetings are announced through the mailing list. We will post notes for those who are not able to attend. These meetings will focus on topics that are of interest to the connector instructors.
-
-### Mailing List
-
-You should have been added to the connector instructor mailing list/google group. If you are not sure whether you have been added, you can view all your memberships at [groups.google.com](/groups.google.com). To email all instructors on the mailing list, you can send an email to [[email protected]](mailto:[email protected]).
-

myst.yml

@@ -7,12 +7,97 @@ project:
   # keywords: []
   # authors: []
   github: https://github.com/berkeley-cdss/curriculum-guide
-  # To autogenerate a Table of Contents, run "myst init --write-toc"
   license:
     # code: MIT
     content: CC-BY-4.0
   jupyter:
     lite: true
+  abbreviations:
+    CDSS: College of Computing, Data Science, and Society
+    BIDS: Berkeley Institute of Data Science
+    CA: Connector assistant
+    CI: Connector instructor
+    DEC: Data-enabled course
+    repo: Git repository, either local or on GitHub
+  toc:
+    - file: intro.md
+    - title: DataHub Technology
+      children:
+      - file: technology/introduction-to-jupyter.md
+      - file: technology/jupyterlab.md
+      - file: technology/rstudio.md
+      - file: technology/shiny.md
+      - file: technology/quarto.md
+      - file: technology/remote-desktop.md
+      - file: technology/vscode.md
+      - file: technology/real-time-collaboration.md
+      - file: technology/syncthing.md
+      - file: technology/jupyter-ai.md
+    - title: DataHub Workflows
+      children:
+      - file: workflows/logging-in.md
+      - file: workflows/creating-notebooks.md
+      - file: workflows/notebook-zero.md
+      - file: workflows/distributing-files.md
+      - file: workflows/pushing-to-github.md
+      - file: workflows/securely-push-github.md
+      - file: workflows/nbgitpuller-link.md
+      - file: workflows/install-packages.md
+      - file: workflows/elevated-privileges.md
+      - file: workflows/accessibility.md
+      - file: workflows/collecting-grading-assignments.md
+      - file: workflows/save-files-as-pdf.md
+      - file: workflows/download-archive.md
+      - file: workflows/performance-issue.md
+      - file: workflows/calculate-compute-cost.ipynb
+      - file: workflows/storing-datasets.md
+      - file: workflows/bestpractices.md
+      - file: workflows/external-technology.md
+      # FIXME: r-datahub has very little to do with using R on DataHub
+      - file: workflows/r-datahub.md
+    - title: Support
+      children:
+      - file: support/communication.md
+      - file: support/common-requests.md
+      - file: support/onboarding.md
+      - file: support/memory-cpu.md
+      - file: support/workshop-research.md
+      - file: support/new-hub.md
+      - file: support/learn-more.md
+      - title: Troubleshooting
+        children:
+        - file: support/troubleshooting/jupyter.md
+        - file: support/troubleshooting/python.md
+        - file: support/troubleshooting/nbgitpuller.md
+        - file: support/troubleshooting/otter-grader.md
+        - file: support/troubleshooting/rstudio.md
+      - file: support/contributors.md
+    - title: Resources for Students
+      children:
+      - file: students/before-semester.md
+      - file: students/during-semester.md
+      - file: students/after-semester.md
+      - file: students/equipment-lending.md
+    - title: Modules and Connectors
+      children:
+      - file: connector/general/what-is-a-connector.md
+        children:
+        - file: connector/general/previous-connectors.md
+      - file: module/general/what-is-a-module.md
+      - file: dec/general/what-is-a-data-enabled-course.md
+    - title: Creating a Connector
+      children:
+      - file: connector/instructor/logistics.md
+      - file: connector/instructor/syllabus-design.md
+      - file: connector/instructor/student-help.md
+      - file: connector/instructor/communication-channels.md
+      - file: connector/instructor/checklist.md
+    - title: Creating a Module
+      children:
+      - file: module/instructor/preplanning.md
+      - file: module/instructor/develop.md
+      - file: module/instructor/deploy-help.md
+
 site:
   template: book-theme
   title: UC Berkeley Data Science Curriculum Guide

support/contact-us.md → support/communication.md

@@ -1,5 +1,5 @@
 ---
-title: Contact Us
+title: Communication
 ---
 
 ## GitHub Issues
@@ -21,3 +21,7 @@ We are trying to build a cadence by sending public announcements about feature r
 ```{tip}
 You can track our current priorities for this project on our [sprint board](https://github.com/berkeley-dsep-infra/datahub/projects).
 ```
+
+## Mailing Lists
+
+Instructors will be added to the [[email protected]](mailto:[email protected]). If you are not sure whether you have been added, you can view all your memberships at [groups.google.com](https://groups.google.com).

reference/contributors.md → support/contributors.md

@@ -6,12 +6,12 @@ Here are the people in involved with DataHub Infrastructure and Modules team
 
 | Name | Role |
 | :--- | :--- |
-| [Eric Van Dusen](mailto:[email protected]) | Tech and Outreach Lead at DSUS |
-| [Shane Knapp](mailto:[email protected]) | Technical Lead, DataHub Infrastructure |
 | [Balaji Alwar](mailto:[email protected]) | Service Lead for JupyterHub Infrastructure 
-| [Ryan Lovett](mailto:[email protected]) | Manages JupyterHub Infrastructure |
 | [Jonathan Felder](mailto:[email protected]) | Manages JupyterHub Infrastructure |
+| [Shane Knapp](mailto:[email protected]) | Technical Lead, DataHub Infrastructure |
+| [Ryan Lovett](mailto:[email protected]) | Manages JupyterHub Infrastructure |
 | [Greg Meritt](mailto:[email protected]) | Manages JupyterHub Infrastructure |
+| [Eric Van Dusen](mailto:[email protected]) | Tech and Outreach Lead at DSUS |
 
 Previous Contributors:
 Gunjan Baid, Yuvi Panda, Chris Pyles, Anthony Suen, Keeley Takimoto