aboutsummaryrefslogtreecommitdiff
path: root/README.org
Commit message (Collapse)AuthorAgeFilesLines
* docs: trim README — drop quick-sdcv comparison + bare-repo asideCraig Jennings2026-04-301-8/+1
|
* docs: expand README with usage examplesCraig Jennings2026-04-301-4/+317
| | | | | | | | | | | | | | | | | | | | Replaces the placeholder with full usage docs modelled on chime's README but tighter — gloss is a smaller package, the doc shouldn't out-bulk it. Sections: nav links, status, why-not-quick-sdcv, features, installation (package-vc-install / use-package :vc / straight / manual), quick start (lookup and add flows), the C-h g keybinding table plus the gloss-add-mode binding table, the four defcustoms with rationale, extending the source registry for v2+, org-drill integration, troubleshooting (libxml absent, network failures, file corruption, cache out of sync, side-window dismiss), development (Cask + ert-runner + Make targets), license. The keybinding table is the source of truth — every entry matches what `gloss-prefix-map' actually binds. The defcustoms section names the four actual customs only (gloss-file, gloss-fetch-sources, gloss-fetch-timeout, gloss-debug); no aspirational knobs.
* chore: scaffold gloss packageCraig Jennings2026-04-281-0/+20
Five layered files per the design at docs/design/gloss.org. gloss-core for the data layer, gloss-fetch for the network layer, gloss-display for the UI, gloss-drill for the spaced-repetition export, and gloss.el as the entry point. All five are skeletons. Implementation comes next. The Makefile delegates to ert with the usual unit, integration, and per-file targets. It also runs paren and lint passes. The package is licensed GPL-3.0-or-later. README is a placeholder pointing at the design doc.