Update all the README and CONTRIBUTING stuff.

Author: nedtwigg

CONTRIBUTING.md

@@ -1,6 +1,7 @@
 # Contributing to Selfie
 
 - To improve our webpage go to [`selfie.dev/README.md`](selfie.dev/README.md)
+- To improve our Python, go to [`python/README.md`](python/README.md)
 - To improve our JVM, Javascript, or WASM implementations, go to [`jvm/README.md`](jvm/README.md)
   - To improve the webpage of our published kdoc, [kdoc.selfie.dev](https://kdoc.selfie.dev), go to [`jvm/gradle/dokka/README.md`](jvm/gradle/dokka/README.md)
 - To contribute for a different platform (python, go, etc.) we're happy to help! It should probably live in a different repo until it's close to `1.0`, but once it's near completion we're happy to maintain it here if you would like. Discuss in [selfie#85](https://github.com/diffplug/selfie/issues/85), but also feel free to open a PR with any ideas you have.

README.md

@@ -1,31 +1,30 @@
-# Selfie: snapshot testing and [memoizing](https://selfie.dev/jvm/cache) for Java, Kotlin, and the JVM
+# Selfie: snapshot testing and memoizing for Python, JVM, and [(your PR here)](https://github.com/diffplug/selfie/issues/85)
 
 ![gif demo of selfie in action](https://docs.diffplug.com/selfie/selfie-demo.gif)
 
 ## Key features
 
-- Just [add a test dependency](https://selfie.dev/jvm/get-started#installation), zero setup, zero config.
-- Snapshots can be [inline literals](https://selfie.dev/jvm#literal) or [on disk](https://selfie.dev/jvm#like-a-filesystem).
-- Use `expectSelfie` for testing or `cacheSelfie` for [memoizing expensive API calls](https://selfie.dev/jvm/cache).
+- Just add a test dependency ([py](https://selfie.dev/py/get-started#installation), [jvm](https://selfie.dev/jvm/get-started#installation)), zero setup, zero config.
+- Snapshots can be [inline literals](https://selfie.dev/py#literal) or [on disk](https://selfie.dev/py#like-a-filesystem).
+- Use `expect_selfie` for testing or `cache_selfie` for [memoizing expensive API calls](https://selfie.dev/py/cache).
 - Disk snapshots are automatically [garbage collected](https://github.com/diffplug/selfie/blob/main/jvm/selfie-runner-junit5/src/main/kotlin/com/diffplug/selfie/junit5/SelfieGC.kt) when the test class or test method is removed.
-- Snapshots are **just strings**. Use html, json, markdown, whatever. No [magic serializers](https://selfie.dev/jvm/facets#typed-snapshots).
+- Snapshots are **just strings**. Use html, json, markdown, whatever. No [magic serializers](https://selfie.dev/py/cache#roundtripping-typed-data).
 - Record **multiple facets** of the entity under test, e.g. for a web request...
   - store the HTML as one facet
   - store HTML-rendered-to-markdown as another facet
   - store cookies in another facet
   - **assert some facets on disk, others inline**
-  - see gif above for live demo, detailed example [here](https://selfie.dev/jvm/advanced)
+  - see gif above for live demo, detailed example [here](https://selfie.dev/py/facets#harmonizing-disk-and-inline-literals)
 
-JVM only for now, [python](https://github.com/diffplug/selfie/issues/170) is in progress, other platforms on the way: [js](https://github.com/diffplug/selfie/issues/84), [.NET, go, ...](https://github.com/diffplug/selfie/issues/85)
+Python and JVM ports are both production-ready, other platforms on the way: [js](https://github.com/diffplug/selfie/issues/84), [.NET, go, ...](https://github.com/diffplug/selfie/issues/85)
 
 ## Documentation
 
-- [Installation](https://selfie.dev/jvm/get-started#installation)
-- [Quickstart](https://selfie.dev/jvm/get-started#quickstart)
-- [Facets](https://selfie.dev/jvm/facets)
-- [Caching / memoizing](https://selfie.dev/jvm/cache)
-- [Why selfie](https://selfie.dev/jvm)
-- [API reference](https://kdoc.selfie.dev/)
+- Quickstart **([py](https://selfie.dev/py/get-started#quickstart), [jvm](https://selfie.dev/jvm/get-started#quickstart))**
+- Facets **([py](https://selfie.dev/py/facets), [jvm](https://selfie.dev/jvm/facets))**
+- Caching / memoizing **([py](https://selfie.dev/py/cache), [jvm](https://selfie.dev/jvm/cache))**
+- Why selfie **([py](https://selfie.dev/py), [jvm](https://selfie.dev/jvm))**
+- API reference **([py](https://pydoc.selfie.dev/namespacemembers_func), [jvm](https://kdoc.selfie.dev/))**
 
 ## Contributing
 

jvm/README.md

@@ -1,9 +1,8 @@
 # Selfie snapshot testing for Java, Kotlin, and the JVM
 
-- [Quickstart](https://selfie.dev/jvm/get-started)
-- [Facets](https://selfie.dev/jvm/facets)
-- [Caching / memoizing](https://selfie.dev/jvm/cache)
-- [Why selfie](https://selfie.dev/jvm)
+- High-level documentation - [selfie.dev](https://selfie.dev/jvm/get-started).
+- API documentation - [pydoc.selfie.dev](https://kdoc.selfie.dev).
+- Source code - [github.com/diffplug/selfie](https://github.com/diffplug/selfie)
 
 ## Contributing
 

python/README.md

@@ -1,10 +1,12 @@
+# Selfie snapshot testing for Python
+
 - High-level documentation - [selfie.dev](https://selfie.dev/py/get-started).
 - API documentation - [pydoc.selfie.dev](https://pydoc.selfie.dev/namespaces).
 - Source code - [github.com/diffplug/selfie](https://github.com/diffplug/selfie)
 
 ## Contributing
 
-Dependencies are managed using uv:
+PR's welcome! Dependencies are managed using uv:
 
 - https://docs.astral.sh/uv/getting-started/installation/
 - then cd into `selfie-lib` and run `uv sync` to get the dependencies