Edit and Update: Enhancements to Cal-ITP Data Services Documentation

[shweta487]

Introduction
This issue focuses on updating the Cal-ITP Data Services documentation as part of a broader initiative to enhance the analyst curriculum.

Files Affected:
Cal-ITP Data Services Documentation

The following specific tasks will be addressed:

Remove outdated components

• Eliminate references to outdated components in the documentation.
  Remove Github Analytics Project Board

Update Urls

• Add link to Python Libraries: calitp-data-analysis and siuba

Update Contents

• JupyterHub: Default vs Power Users
• Tool Quick Links: Project Board Purpose
• Helpful Links
  • ReviewNB
• Metabase Tutorial
• How to publish in Metabase
• Python Libraries used in the new exercises
• Saving Code Common Issues
• Visualization Use Case like publishing data to pdfs
• GCS Public Data Bucket
• Big Query in GCS
• Description of key terminologies and Acronyms used like CSIS, SB125

Additional Resources

• Organizational Chart and DOTP Resources such as Transportation Planning Handbook
• Tidy Data
• Caltrans Employee Resources
• External tutorials
  • Practical Python for Data Science
  • Jupyter Notebook Tutorial
  • General Python Functions

Update Exercise related content and chronology

• Update existing code examples with relevant modifications and context.
• Revise the chronology of exercises to better align with new content and learning objectives.

[amandaha8]

For this page, there's a part that says "Still need access to a tool on this page? Ask in the #services-team channel in the Cal-ITP Slack." I don't think that channel exists anymore so maybe this should be replaced?

[amandaha8]

I feel like we can erase everything after the Communication Channels on this How We Work page but I think you already did this!

[amandaha8]

For helpful links you can erase

• Have something you want to share? Create a new markdown file, add it to the example report folder, and message Amanda..
• Under "Merging", delete out Potential Solution GitHub Action for nbviewer link generation #3: if you don’t have too many values, use a dictionary..
• Under "Maps", delete out Examples of folium, branca, and color maps.

[amandaha8]

You mentioned talking about when turning a notebook into a PDF and it's addressed here.

• The only edit you have to make is to delete this text: There are assignments that require you to rerun the same notebook for different values and save each of these new notebooks in PDF format. This essentially combines parameterization principles using papermill with the weasyprint steps above. You can reference the code that was used to generate the CSIS scorecards here. This script iterates over this notebook to produce 50+ PDF files for each of the nominated projects..
• Then paste in this text: There are assignments that require you to rerun the same notebook for different values and save each of these new notebooks in PDF format. This essentially combines parameterization principles using papermill with the weasyprint steps above. You can reference the code that was used to generate the CSIS scorecards here. This script iterates over this notebook to produce PDF files for each of the nominated projects found here.

[amandaha8]

Do you know what you are supposed to write for the GCS public bucket? I am not really familiar with this, never used this public bucket before. Maybe Eric or Tiffany can work on this page?

[KatrinaMKaiser]

For this page, there's a part that says "Still need access to a tool on this page? Ask in the #services-team channel in the Cal-ITP Slack." I don't think that channel exists anymore so maybe this should be replaced?

fyi services-team still exists! It's in External Connections.

[amandaha8]

There is a broken link on this page. I highlighted the sentence in bold.

Our team often uses Google Cloud Storage (GCS) for object storage. If you haven’t set up your Google authentication, go here for the instructions. For a walkthrough on how to use GCS buckets, go here.