Matt Fisher

Mkdocs build is very slow (jupyter notebooks re-rendering even when no changes)

3

Mkdocs currently lacks caching features we would need to fix this: https://github.com/danielfrg/mkdocs-jupyter/issues/161

A small sample of examples that the user might be interested in following the initial "quick win" example. E.g. : * out of region streaming (cc @cboettig) * ??

I think we should add a new "Explanation" (the 4th diataxis category) section for this. What considerations should users be aware of? The problem: fsspec read-ahead is poorly optimized for...

#521 proposed a maintainer doc, but that would be an addition, not a refactor. This ticket is for the new documentation. Related: #529 * How to become a maintainer? *...

Add "how we work together" docs

3

Should be part of the contributing docs. Link out to openscapes team culture documentation, talks, etc. Related: #514 #525 #521 EDIT: Also #537 . I feel there's an obligation on...

We need a contributor troubleshooting doc to help with some common pitfalls or pain points. E.g. "Why am I getting `vcr.errors.CannotOverwriteExistingCassetteException`?"

I find the doc a bit overwhelming to traverse to find the thing I'm looking for. I think it could stand to be made in to a category. Perhaps subpages...

Add contributing naming convention page

11

For example, in our docs, do directories and file names use hyphens or underscores as separators?

Find an _earthaccess_ PR for a bugfix and feature. They should be: * Small * Explainable * Include unit tests They should be linked at or near where we currently...

"Soften" contributor requirements like unit tests

4

Some contributing requirements may be intimidating users from contributing. Let's change our language in the contributing guide to indicate: If you're not comfortable writing unit tests, we still welcome your...