update python README and TODO

2 files changed, 25 insertions, 17 deletions

diff --git a/python/README.md b/python/README.md
index 8f252512..9b244e2d 100644
--- a/python/README.md
+++ b/python/README.md
@@ -1,5 +1,26 @@
 
-## Python Web Interface
+## Fatcat Python Code
+
+This directory contains all python code for the fatcat project: an API client
+library (`fatcat_client`), a web interface (`fatcat_web`), and a series of
+utilities and worker processes (`fatcat_tools`).
+
+Most of this code is an "application" which is tightly interwoven and intended
+to be run from this directory, but the client library is distributed on
+pypi.org.
+
+## Client Library
+
+The auto-generated python client library for the fatcat API lives under
+`./fatcat_client`. It includes entity model objects and functions to call all
+API endpoints; see `./README_client.md` for details.
+
+To re-generate swagger-codegen python client library (requires docker installed
+locally):
+
+    ./codegen_python_client.sh
+
+## Web Interface
 
 This project uses `pipenv` to manage dependencies, and assumes Python 3.5
 (which pipenv may install if you are running a different local version). You
@@ -13,17 +34,6 @@ server on the same machine by default), use:
     # will listen on http://localhost:9810 by default
     pipenv run fatcat_webface.py
 
-## Python Client Library
-
-An auto-generated python client library for the fatcat API lives under
-`./fatcat_client`. It includes entity model objects and functions to call all
-API endpoints; see `./README_client.md` for details.
-
-To re-generate swagger-codegen python client library (requires docker installed
-locally):
-
-    ./codegen_python_client.sh
-
 ## Running Tests
 
 Many (though not all) python tests depend on access to a local running API
diff --git a/python/TODO b/python/TODO
index 7a6eb10f..46fceb69 100644
--- a/python/TODO
+++ b/python/TODO
@@ -1,9 +1,7 @@
 
-Idea for new module structure: refactor 'fatcat_client' into 'fatcat' and have
-that be the general purpose API client. create a new 'fatcat_services' for web
-interface, importers, workers, etc, which depends on the other module.
-potentially, move library module into subdirectory or another top-level folder
-("python-fatcat"? "python-library"?).
+Idea for further module simplification: move codegen'd library into it's own
+directory (with it's own README, tests, etc), and reference it here via
+symlink.
 
 - use dict counter type (in python collections) instead of currently janky counters
 - schema.org metadata for releases