| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
I moved both v0 design specs out of working/ and into docs/design/. That's the conventional permanent home for project documentation, where engineers will look during implementation. working/ is meant for transient in-progress artifacts that file away once the work ships, and these specs are long-lived design docs that don't fit that contract.
Files moved:
- working/stats-dashboard/stats-dashboard.org → docs/design/stats-dashboard.org
- working/fsrs-spec/fsrs-spec.org → docs/design/fsrs-spec.org
The git rename detection picked both up, so file history follows the move.
I also dropped the stale /docs entry from .gitignore. The Makefile doesn't write to docs/ and nothing else references it as a build output, so the ignore was inherited cruft that would have silently dropped any tracked file under docs/.
I updated path references in seven spots: three docstring/comment refs in org-drill.el, one in tests/test-org-drill-session-record.el (the Commentary block), and three inside the specs themselves. Two refs in fsrs-spec.org now point at the correct location for its defcustom docstring and option description. One in stats-dashboard.org's References section points at the sister spec.
Full make test-unit green. eask compile clean.
|
|
|
I drafted a design spec for adding FSRS (Free Spaced Repetition Scheduler) as a fourth choice in org-drill-spaced-repetition-algorithm. It pins FSRS-4.5 as the version target, documents the DSR state model, the rating mapping from org-drill's 0-5 quality to FSRS's 1-4 scale, the update equations, the new DRILL_FSRS_* properties, and the integration shape into the existing scheduler dispatch.
The spec is v0 with six explicit DECIDE: markers carrying recommended defaults: version pin, parameter tuple, quality mapping, return shape, cold-start UI, and equation cross-check. The companion todo entry stays open at todo.org:125 until those land and implementation begins. The file moves to fsrs-spec.org at the project root once the DECIDEs resolve.
|
