aboutsummaryrefslogtreecommitdiffstats
path: root/docs/superpowers
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-08-20 18:36:40 +0200
committerDanilo M. <danix@danix.xyz>2026-08-20 18:36:40 +0200
commitff76a8fc6c050de121a277faa1937eeec9ac4641 (patch)
tree6428753e05271cc7267d4ba684f80d6e161fa3e3 /docs/superpowers
parentccf6f436c00d95c2caa696d583ec23d667ff3e60 (diff)
downloadqtmaildir-ff76a8fc6c050de121a277faa1937eeec9ac4641.tar.gz
qtmaildir-ff76a8fc6c050de121a277faa1937eeec9ac4641.zip
docs: document the new config keys in the plan's close-out, item 123
Task 2's code review found that the README's sample config documents every other key, including recently added ones, and has nothing for send_command or the [compose] section. Without it those keys ship undiscoverable: a user has no way to learn that sending exists at all. That is a gap in the plan rather than a deviation by the task, since no task claimed the README, so it becomes a step in the close-out where the rest of the documentation is written.
Diffstat (limited to 'docs/superpowers')
-rw-r--r--docs/superpowers/plans/2026-08-20-compose-and-send.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/superpowers/plans/2026-08-20-compose-and-send.md b/docs/superpowers/plans/2026-08-20-compose-and-send.md
index 195dacc..1478f59 100644
--- a/docs/superpowers/plans/2026-08-20-compose-and-send.md
+++ b/docs/superpowers/plans/2026-08-20-compose-and-send.md
@@ -4787,6 +4787,21 @@ replace.
- Modify: `docs/superpowers/plans/2026-08-03-post-0.1.0-usability.md`
- Modify: `docs/superpowers/specs/2026-08-20-compose-and-send-design.md`
+- [ ] **Step 0: Document the new keys in the README**
+
+Found during Task 2's code review and assigned here rather than there. The
+README's sample config at `README.md:150-215` documents EVERY other
+configuration key, including recently added ones, and has nothing for
+`send_command` or the `[compose]` section. Without this the keys ship
+undiscoverable: a user has no way to learn that sending exists.
+
+Take the block from the spec at
+`docs/superpowers/specs/2026-08-20-compose-and-send-design.md:552-560` and
+adapt it to the README's existing commented style, showing `send_command` in
+an account section and every `[compose]` key with its default. Say plainly
+that an account without `send_command` is receive-only, since that is the
+part no reader would guess.
+
- [ ] **Step 1: Add the changelog entry**
Under `## [Unreleased]`, in the existing `### Added` section or a new one: