John O'Keefe
0d4698c0de
The tenth and final page: the section directory with one-line coverage per page, the fresh-instance quick path (libraries -> scan -> Base URL -> users -> devices), and the when-something-looks-wrong triage table mapping symptoms to pages. The portal (index.md) gains a For Administrators area listing all nine admin pages; the user guide's 'being expanded separately' line becomes the done-state sentence. Every control name quoted here exists in the glossary.
129 lines
6.9 KiB
Markdown
129 lines
6.9 KiB
Markdown
# Bookhoard Documentation
|
|
|
|
Complete guide to Bookhoard documentation. Find what you need quickly.
|
|
|
|
---
|
|
|
|
## 🚀 By Audience
|
|
|
|
### 👤 For End Users
|
|
|
|
**[User Documentation Portal](user/user-guide.md)** - Guides for using Bookhoard features
|
|
|
|
- **Device Setup**
|
|
- [KOReader Setup Guide](user/devices/koreader-setup.md) - KOReader on Kindle/Kobo/PocketBook hardware
|
|
- [Kobo Setup Guide](user/devices/kobo-setup.md) - Native Kobo sync (coming soon; use KOReader today)
|
|
- [Android App](user/devices/android-app.md)
|
|
|
|
- **Sync Configuration**
|
|
- [Universal Sync Guide](user/sync-guide.md) - Understanding sync, book matching, conflicts
|
|
|
|
- **Filters**
|
|
- [Filters — the complete guide](user/filters/index.md) - rules, groups (ALL/ANY), saved filters, smart collections
|
|
- [Filter cookbook](user/filters/cookbook.md) - ready-made recipes, exact clicks
|
|
- [Every filter field](user/filters/fields.md) - the generated, always-current reference
|
|
|
|
- **Guides**
|
|
- [Reader Guide](user/reader-guide.md) - reading, highlights, notes
|
|
- [Library Browsing](user/library-browsing.md) - browsing and searching your library
|
|
- [Collections](user/collections.md) - manual and ⚡ smart shelves, books and episodes
|
|
- [Podcasts](user/podcasts.md) - feeds, downloads, listening
|
|
- [Dashboard](user/dashboard.md)
|
|
- [Themes](user/themes.md)
|
|
- [Calibre Integration](user/calibre-integration.md)
|
|
- [Profile Guide](user/profile-guide.md)
|
|
|
|
### 🛡 For Administrators
|
|
|
|
**[Admin Guide](admin/admin-guide.md)** - running a Bookhoard instance: every admin page, what each control actually does
|
|
|
|
- **Administration**
|
|
- [Admin Dashboard](admin/dashboard.md) - stats, Force Rescan All Libraries, scan progress
|
|
- [Libraries](admin/libraries.md) - create libraries, folders, user access, scanning
|
|
- [Processing Issues](admin/library-processing-issues.md) - items the scanner couldn't process
|
|
- [Archived Items](admin/archived-items.md) - missing files, history-preserving archive
|
|
- [All Podcasts](admin/podcasts.md) - the maintenance view for every feed
|
|
- [Hash Conflicts](admin/hash-conflicts.md) - duplicate content resolution
|
|
- [Users](admin/users.md) - accounts, roles, password resets
|
|
- [System Settings](admin/settings.md) - every setting: key, default, range, meaning
|
|
- [Scanning](admin/scanning.md) - shallow vs. force: what every scan button does
|
|
|
|
### 👨💻 For Developers
|
|
|
|
**[Developer Documentation Portal](developer/development.md)** - Technical documentation & API reference
|
|
|
|
- **API Documentation** — every endpoint is documented individually; the links below are entry points
|
|
- [API Reference overview](developer/api/api-reference.md) - index of all endpoint docs
|
|
- [Collections API](developer/api/collections/list_collections.md) - collections management API
|
|
- [Media Items API](developer/api/media-items/list_media_items.md) - media item operations including bulk operations and downloads
|
|
- [Devices API](developer/api/devices/list_devices.md) - Device sync and shelf management
|
|
- [Conflicts API](developer/api/conflicts/list_conflicts.md) - Sync conflict resolution endpoints
|
|
- [Queue API](developer/api/queue/list_all_queue_items.md) - Sync queue management endpoints
|
|
- [Scanner API](developer/api/scanner/overview.md) - Library scanning and automated watch mode (admin)
|
|
- [KOReader API](developer/api/koreader/get_library.md) - KOReader sync protocol endpoints
|
|
- [Kobo API](developer/api/kobo/sync_from_server.md) - Kobo sync protocol endpoints
|
|
- [Admin API](developer/api/admin/list_users.md) - User management (admin operations); content-duplicate cleanup lives in [hash conflicts](developer/api/admin/hash_conflicts_api.md)
|
|
|
|
- **Protocol Specifications**
|
|
- [KOReader Sync Protocol](developer/api/sync/koreader-protocol.md) - KOReader sync
|
|
- [Kobo Sync Protocol](developer/api/sync/kobo-protocol.md) - Kobo device sync
|
|
|
|
- **Writing UI docs?** Read [Writing UI documentation without screenshots](developer/writing-ui-docs.md) first.
|
|
|
|
### 🔧 For Operations
|
|
|
|
**[Operations Documentation Portal](operations/operations.md)** - Deployment & maintenance
|
|
|
|
- [Troubleshooting Guide](operations/troubleshooting.md) - Common deployment issues and solutions
|
|
|
|
### 🤝 For Contributors
|
|
|
|
**[Contributing Portal](contributing/contributing.md)** - Development workflow
|
|
|
|
- [Development Guide](contributing/development.md) - Architecture, setup, testing, and the project rules
|
|
|
|
---
|
|
|
|
## 📚 Quick Links
|
|
|
|
| Want to... | Go to |
|
|
| -------------------- | ---------------------------------------------------------------------- |
|
|
| **Get started** | [Development Guide](contributing/development.md) - Architecture and quick start |
|
|
| **Set up a device** | [User Portal → Device Setup](user/user-guide.md) |
|
|
| **Use the API** | [API Reference overview](developer/api/api-reference.md) |
|
|
| **Deploy Bookhoard** | [Operations → Troubleshooting](operations/troubleshooting.md) |
|
|
| **Contribute code** | [Development Guide](contributing/development.md) |
|
|
| **Understand sync** | [User Portal → Sync Guide](user/sync-guide.md) |
|
|
| **Read in the browser** | [User Portal → Web Reader Guide](user/reader-guide.md) |
|
|
|
|
---
|
|
|
|
## 🔍 Quick Find
|
|
|
|
### "How do I..."
|
|
|
|
| Question | Answer |
|
|
| --------------------------- | ------------------------------------------------------ |
|
|
| ...set up KOReader? | [KOReader Setup Guide](user/devices/koreader-setup.md) |
|
|
| ...use a Kobo? | [Kobo Setup Guide](user/devices/kobo-setup.md) - native sync coming soon; KOReader works today |
|
|
| ...understand sync? | [Sync Guide](user/sync-guide.md) |
|
|
| ...read in the browser? | [Web Reader Guide](user/reader-guide.md) - reading, highlights, notes |
|
|
| ...resolve conflicts? | [Sync Guide](user/sync-guide.md) - Managing Conflicts |
|
|
| ...troubleshoot deployment? | [Troubleshooting Guide](operations/troubleshooting.md) |
|
|
| ...use the API? | [API Reference overview](developer/api/api-reference.md) |
|
|
| ...write UI docs? | [Writing UI documentation](developer/writing-ui-docs.md) |
|
|
| ...contribute code? | [Development Guide](contributing/development.md) |
|
|
|
|
---
|
|
|
|
## 📝 Contributing to Documentation
|
|
|
|
When adding new features:
|
|
|
|
1. **User-facing features** → Update the relevant User docs
|
|
2. **API endpoints** → Update the endpoint docs under `developer/api/` (start from the [API Reference overview](developer/api/api-reference.md))
|
|
3. **Backend changes** → Update the [Development Guide](contributing/development.md)
|
|
4. **Deployment changes** → Update the [Operations Portal](operations/operations.md)
|
|
5. **New UI controls in docs** → Add them to the [UI controls glossary](developer/ui-controls.md)
|
|
6. **UI appearances in docs** → Follow [Writing UI documentation without screenshots](developer/writing-ui-docs.md)
|