392 restructure october 2025

[matthew-ballard]

• snake_case
• ordered notebooks when relevant with 0_, 1_
• contributing guide is updated to reflect standards
• uses new proposed hierarchy
• deprecate handful of notebooks
• adds a new TOC of notebooks
• updates to the main repo readme file
• removed tests. The test script was not working, and not being used. We should rethink approach to tests later.

STILL NEED TO DO: all of the colab links are broken- once this is finalized, I will update

[matthew-ballard]

Also closes #387 #389 and #391

[tbarsballe]

Thanks for all the reorganization here. I've added a few comments, mostly minor changes.

As a more general comment - I've noticed a significant mismatch between notebook filenames and titles in many cases - e.g. "calculate_water_extent_analysis_ready_planetscope.ipynb" vs "Intro to ARPS data in Planet Insights Platform".

1. Is this something worth improving?
2. If so, we should also add guidance around this to the CONTRIBUTING.md

[matthew-ballard]

As a more general comment - I've noticed a significant mismatch between notebook filenames and titles in many cases - e.g. "calculate_water_extent_analysis_ready_planetscope.ipynb" vs "Intro to ARPS data in Planet Insights Platform". Is this something worth improving?

I feel like these types of changes can come after the reorganization, what do you think? I think it can be a gradual improvement over time

[tbarsballe]

TOC updates look good, added some comments on the Auth updates

[tbarsballe]

As a more general comment - I've noticed a significant mismatch between notebook filenames and titles in many cases - e.g. "calculate_water_extent_analysis_ready_planetscope.ipynb" vs "Intro to ARPS data in Planet Insights Platform". Is this something worth improving?

I feel like these types of changes can come after the reorganization, what do you think? I think it can be a gradual improvement over time

Agreed, I think that can be part of the per-notebook cleanup. Though we'll probably want to call that out specifically when requesting help from other teams.

[sbueche]

Looks good to me, nothing more to add

[matthew-ballard]

• update colab links in all noteboks
• add a callout for Planet Sandbox Data notebooks to replace this current landing page used in the trial
• finish doc site update to push at the same time