LibrePortal/docs/README.md
librelad 30612a0d87 docs: organize docs/ into purpose folders with consistent naming
Sort docs/ into guide/ contributing/ architecture/ roadmap/ and rename
to consistent kebab-case (USER->guide/install-and-use, FOOTPRINT->
architecture/system-footprint, frontend-modularization->architecture/
webui-architecture, etc.). Add a docs/README.md index and a docs/
CONTRIBUTING.md pointer so the forge still surfaces the contributing
guide. Fix every reference (README, init.sh comments, frontend code
comments, and the USER<->DEVELOPMENT cross-links). History preserved
via git mv. Root stays README.md + CLAUDE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: librelad <librelad@digitalangels.vip>
2026-05-31 00:48:38 +01:00

20 lines
1.1 KiB
Markdown

# LibrePortal docs
Sorted by audience. Start with **guide/** if you're running LibrePortal,
**contributing/** if you're hacking on it.
## guide/ — using LibrePortal
- [install-and-use.md](guide/install-and-use.md) — install, place data on separate disks, update, back up, uninstall.
- [promise.md](guide/promise.md) — the LibrePortal Promise: free/open, no paywalls, no telemetry, in plain language.
## contributing/ — working on LibrePortal
- [contributing.md](contributing/contributing.md) — how to contribute (DCO sign-off, no CLA).
- [development.md](contributing/development.md) — run a dev copy, cut stable/edge releases, test before publishing.
## architecture/ — how it's built
- [system-footprint.md](architecture/system-footprint.md) — everything LibrePortal places outside its data roots, and who owns it.
- [webui-architecture.md](architecture/webui-architecture.md) — the WebUI component-module system (as-built).
## roadmap/ — where it's going
- [updates-and-distribution.md](roadmap/updates-and-distribution.md) — vision for hotfixes, the "Updates & Improvements" front door, and registry-not-marketplace distribution.