From 7e2e1c4c6091d17a01885c281a5fa0895d893f5d Mon Sep 17 00:00:00 2001 From: John O'Keefe Date: Mon, 2 Nov 2026 13:34:21 -0500 Subject: [PATCH] docs: remove speculative promise language, de-brand Android design analogy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Owner rulings from the admin-docs planning session: - sync-guide: dropped 'Kindle and reMarkable are under consideration' — no such plans exist, and promising support for proprietary device interfaces we will never build sets false expectations. Device posture stays as the table states it: web, Android app, KOReader anywhere (including jailbroken Kindle hardware), native Kobo the sole exception. - calibre-integration: cut 'Custom Calibre Columns (Future)' + 'Stay tuned!' — unshipped-feature promises do not belong in docs; calibre integration is a by-product of the scanner's sidecar support, not a roadmap item. The features list describing Calibre itself stays (that is Calibre's promise, not ours). - android-app: de-branded the two Kindle references per owner's legal caution — 'the Kindle app to Kindle cloud' analogy and 'quality bar is the Kindle app' are now 'any dedicated reader app to its server' / 'a first-class native reader app'; engineering substance unchanged. Governance rule going forward (codified in writing-ui-docs.md in a follow-up): no future-improvement or coming-soon language anywhere without explicit owner approval; anything found gets reported, not silently kept or silently removed. --- docs/developer/android-app.md | 4 ++-- docs/user/calibre-integration.md | 10 ---------- docs/user/sync-guide.md | 3 --- 3 files changed, 2 insertions(+), 15 deletions(-) diff --git a/docs/developer/android-app.md b/docs/developer/android-app.md index 36e2dc7c..559a0bda 100644 --- a/docs/developer/android-app.md +++ b/docs/developer/android-app.md @@ -1,6 +1,6 @@ # Android App — Design & Roadmap -This document describes the planned native Android client for Bookhoard: a thin, offline-first reading app that treats the Bookhoard server as its backend. The relationship is the same as the audiobookshelf app to an audiobookshelf server, or the Kindle app to Kindle cloud — the server owns the library, sync, and conflict resolution; the app is a dedicated, mobile-first reading frontend with its own UI, designed independently of the web interface. +This document describes the planned native Android client for Bookhoard: a thin, offline-first reading app that treats the Bookhoard server as its backend. The relationship is the same as any dedicated reader app to its server: the server owns the library, sync, and conflict resolution; the app is a dedicated, mobile-first reading frontend with its own UI, designed independently of the web interface. **Status**: Planning / pre-development **Companion repo**: `bookhoard-app` (separate repository, AGPL-3.0) @@ -32,7 +32,7 @@ This document describes the planned native Android client for Bookhoard: a thin, ### Why native Android -- The quality bar is the Kindle app. Page-turn latency, text layout fidelity, PDF rendering (`PdfRenderer`), and comic/manga image pipelines are platform-level strengths — and they are the *hard* parts in a WebView, not the easy parts. +- The quality bar is a first-class native reader app. Page-turn latency, text layout fidelity, PDF rendering (`PdfRenderer`), and comic/manga image pipelines are platform-level strengths — and they are the *hard* parts in a WebView, not the easy parts. - Android-first removes the "share one codebase across two platforms simultaneously" constraint that motivates hybrid stacks. - Solo, AI-assisted development compresses the cost of native (code volume), while native's failure modes (well-documented platform APIs) are far easier to debug — alone or with AI — than cross-framework bridge/plugin bugs. - The target audience is the self-hosted community, best reached via GitHub Releases and F-Droid rather than app-store optimization. diff --git a/docs/user/calibre-integration.md b/docs/user/calibre-integration.md index 9b9beeaa..32529913 100644 --- a/docs/user/calibre-integration.md +++ b/docs/user/calibre-integration.md @@ -248,16 +248,6 @@ As long as a `metadata.opf` file exists in the folder, Bookhoard will import the ## Advanced Usage -### Custom Calibre Columns (Future) - -Bookhoard may support Calibre custom columns in a future release. This would allow you to import: -- Read status -- Favorite flags -- Custom metadata fields -- User-defined categories - -Stay tuned for updates! - ### OPDS Integration You can access your Bookhoard library (including Calibre-imported books) via OPDS from OPDS-capable clients: diff --git a/docs/user/sync-guide.md b/docs/user/sync-guide.md index b82dd102..9566a4eb 100644 --- a/docs/user/sync-guide.md +++ b/docs/user/sync-guide.md @@ -14,9 +14,6 @@ notes — and every registered device pushes and pulls against it. | **KOReader** (Kindle, Kobo, PocketBook) | ✅ Fully supported | The Bookhoard KOReader plugin, over Wi-Fi | | **Kobo, stock firmware** | 🚧 Server support complete | The native Kobo protocol is implemented and documented server-side; device-side enablement is the remaining piece — [Kobo Setup](devices/kobo-setup.md) has the details | -Kindle and reMarkable are under consideration; KOReader already covers -several of those devices today. - ## Getting a device into the circle 1. Connect the device to your server (each guide above walks its own path)