Leah Wasser

Add: new page overviewing CI

3

This pr is the final piece of content from the now closed pr #104 that was opened in september. it contains 2 short pages 1. describing CI 2. overviewing code...

Create footnotes to external references

2

In our guidebook review @Midnighter noted that we have a lot of external links to content that will take people away from our guidebook. in many cases it is external...

We had some discussion around the test lessons and adding content on caching for deps in CI. see: * https://github.com/pyOpenSci/python-package-guide/pull/145/files#r1442119731 For simplicity sake - and to keep the page beginner...

[packaging-guide] Tests overview page - add runnable examples to the guidebook

1

In [this comment](https://github.com/pyOpenSci/python-package-guide/pull/104/files#r1340752757) @sneakers-the-rat made a great suggestion to make some test suite examples that would run within our guidebook. I think we can do this with myst-nb but let's...

A lesson on shell / bash setup - related to the dependency page PR

2

In our guide - we spent a bit of time discussing users and various shells. [here is the conversation](https://github.com/pyOpenSci/python-package-guide/pull/106#discussion_r1428339852) in my experience teaching this topic, many don't know / understand...

Tests section of the guide (which isn't started yet!)

20

some very helpful discussion came up in a [recent review here](https://github.com/pyOpenSci/python-package-guide/pull/55#discussion_r1133394322) about tests and when to include them and what to do with data, etc. When we work on our...

Cross linking between author checks in our peer review guide and guidance in the packaging guide

1

ok yes this is confusing isn't it. we should actually link over to the author checks rather than have a requirements list embedded here this is what we have now...

Import matplotcheck classes via root rather than modules

2

This is not an ideal import convention `pt`. Nathan - let's look into being able to import ANY of the mpc tester objects using `mpc.RasterTester`, `mpc.VectorTester`, `mpc.PlotTester` i think we...

ok @nkorinek here is a start to cleanup this PR. A few things we need 1. tests for the following - [ ] A plot with NO image on it...

i'm thinking we have some spatial ones that we don't need. this impacts whether we test using conda or pip installs (conda is much slower to build on actions).