Skip to content

docs: add index README and YAML frontmatter to every doc#14

Merged
rafael5 merged 3 commits into
mainfrom
docs-discoverability-phase0
May 11, 2026
Merged

docs: add index README and YAML frontmatter to every doc#14
rafael5 merged 3 commits into
mainfrom
docs-discoverability-phase0

Conversation

@rafael5
Copy link
Copy Markdown
Collaborator

@rafael5 rafael5 commented May 11, 2026

Summary

  • Adds docs/README.md indexing every document in docs/ with the shared TYPE/CONNECTION vocabulary established across the m-dev-tools org on 2026-05-11.
  • Adds YAML frontmatter (created, last_modified, revisions, doc_type) to every existing doc in docs/. Existing frontmatter is merged, not replaced.
  • Implements Phase 0 of the org-wide docs-discoverability standard. The accepted standard, vocabulary, schema, and 4-phase CI rollout plan live in m-dev-tools/.github at docs/docs-discoverability/README.md (committed via #35).

Test plan

  • Existing make check-docs-prose gate passes (docs/ is still prose-only).
  • docs/README.md lists every doc; labels use the agreed 23-type vocabulary.
  • No existing frontmatter fields lost (verified during the org-wide pass; m-stdlib module docs in particular preserve their module: / synopsis: / errors: / conformance: / etc. fields).

🤖 Generated with Claude Code

rafael5 and others added 3 commits May 10, 2026 22:50
Convert §6.2 of language-cli-survey.md into an actionable punch list
for the remaining Phase 3 work — m fix, m profile, m bench, and
m debug — with explicit dependencies, priority ordering, exit
criteria, and per-subcommand risks. Phase 3a is shipped, so the
plan picks up at 3b.

Add a pointer from language-cli-survey.md so the plan is
discoverable from the source survey.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This reverts c27dbfa. The doc was scoped to m-cli's internal Phase 3
from language-cli-survey.md §6.2 (m fix / m profile / m bench /
m debug), but "Phase 3" in this org refers to the org-level
AI-discoverability Phase 3 (recipes + handshake test) tracked in
.github/docs/. The plan now lands there instead.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Add docs/README.md indexing every document in docs/ with a shared
TYPE/CONNECTION vocabulary used consistently across all m-dev-tools
repos.

Add YAML frontmatter (created, last_modified, revisions, doc_type)
to every existing doc. Existing frontmatter is merged, not replaced.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@rafael5 rafael5 merged commit e19ee2f into main May 11, 2026
1 check passed
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