Problem
The plugin system (custom HTTP layers + Python drop-in plugins) is fully implemented but poorly documented and discoverable:
- Python plugins are invisible - no UI mentions them, no docs, example plugin buried in
test-env/
- No standalone documentation - users rely entirely on inline wizard hints
- Secrets management unclear - UI asks for "secret key names" but doesn't explain
secrets.json
- No real-world examples - no sample configs for common book APIs
- No distinction in UI between HTTP custom layers vs Python plugins
Scope
1. In-app help improvements (templates)
- Add a "Plugin Types" section to the Plugins settings tab explaining both HTTP layers and Python plugins
- Add a "Getting Started" or info card that links to docs
- Improve secrets management guidance in the wizard (explain where to put keys)
2. Documentation page
- Add a
/docs/plugins route (or in-app docs modal) covering:
- Quick start for HTTP custom layers
- Python plugin development guide
- Plugin lifecycle (setup, process, teardown)
- Secrets management
- Troubleshooting
3. Ship example plugin properly
- Move example plugin from
test-env/ to a documented location
- Reference it from the docs/UI
4. Real-world examples
- Google Books API config walkthrough
- Open Library API config walkthrough
Out of scope
Problem
The plugin system (custom HTTP layers + Python drop-in plugins) is fully implemented but poorly documented and discoverable:
test-env/secrets.jsonScope
1. In-app help improvements (templates)
2. Documentation page
/docs/pluginsroute (or in-app docs modal) covering:3. Ship example plugin properly
test-env/to a documented location4. Real-world examples
Out of scope