Skip to content

docs: document lib mode's flatten, and that layout is a no-op there - #12

Merged
Kinflou merged 1 commit into
mainfrom
docs/lib-mode-flatten
Oct 4, 2026
Merged

Kinflou merged 1 commit into
mainfrom
docs/lib-mode-flatten

Conversation

@Kinflou

@Kinflou Kinflou commented Oct 4, 2026

Copy link
Copy Markdown
Member

Summary

Follows cli#36, which fixed the actual bug (a lib-mode target silently ignoring layout, landing at out/<language>/ with no way to opt out) — this is the matching docs update:

  • reference/comline-toml.md: adds flatten to the [[generate.target]] table, a new ### flatten section, and fixes the stale "Only code is implemented" claim for mode.
  • guide/codegen/library-generation.md: explains why <out>/rust/ is nested by default, points at flatten to skip it, and states plainly that layout plays no part in lib mode.

Test plan

  • mkdocs build --strict passes clean

Follows ComlineProject/cli#36 (flatten) — the comline.toml reference
and Library generation guide were both silent on lib mode ignoring
layout entirely, which is exactly what prompted a real "why is it
nesting under rust/" bug report.
@Kinflou
Kinflou merged commit b909486 into main Oct 4, 2026
2 checks passed
@Kinflou
Kinflou deleted the docs/lib-mode-flatten branch October 10, 2026 19:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant