Brummel/AILang
1
0
Fork 0
Code Issues 29 Pull Requests Actions Packages Projects Releases Wiki Activity

Module-level (doc …) diagnostic omits where doc belongs #13

New Issue
Open
opened 2026-05-20 13:21:58 +02:00 by Brummel · 0 comments
Brummel commented 2026-05-20 13:21:58 +02:00
Owner
Copy Link
Copy Source

A (module NAME (doc "…") (fn …)) is correctly rejected (unknown def head \doc`) but the message lists valid def heads without saying doc strings attach *inside* fn/datadefs; an author can read it and conclude doc strings are unsupported. One-line tidy: append a hint like "(doc strings attach insidefn/data` defs, not at module level)". Low cost; verbose-diagnostic-philosophy gap, not a bug.

context: docs/specs/2026-05-18-fieldtest-loop-recur.md friction.

A `(module NAME (doc "…") (fn …))` is correctly rejected (`unknown def head \`doc\``) but the message lists valid def heads without saying doc strings attach *inside* `fn`/`data` defs; an author can read it and conclude doc strings are unsupported. One-line tidy: append a hint like "(doc strings attach inside `fn`/`data` defs, not at module level)". Low cost; verbose-diagnostic-philosophy gap, not a bug. **context:** `docs/specs/2026-05-18-fieldtest-loop-recur.md` friction.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
BLOCKER
Core functionality broken — takes precedence over everything else in the queue. /boss preempts current work to handle it
 bug
Observable misbehaviour — surface inconsistency, false positive, wrong output
 feature
Smaller addition inside a milestone, no full spec
 idea
Not yet decision-ready, no commitment
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
claude (Claude) Brummel
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Brummel/AILang#13
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?