Skip to content

docs(profile): voice-clean the org front page and correct its process claims - #12

Merged
lkirc merged 1 commit into
mainfrom
docs/profile-voice
Oct 24, 2026
Merged

lkirc merged 1 commit into
mainfrom
docs/profile-voice

Conversation

@znerol2

@znerol2 znerol2 commented Oct 24, 2026

Copy link
Copy Markdown
Contributor

What & why

The org profile is the first page any visitor sees, and it still had the patterns the umbrella docs no longer use: em dashes and contrast sentences, such as the "enforced" aside in the agents row. This PR rewrites the page in the project voice and corrects the statements that overreached.

  • Voice. No em dashes or contrast sentences remain. The voice check reports 0 errors.
  • Kept word for word. The EBU disclaimer, the video, and every link.
  • Facts corrected against the umbrella docs:
    • Issues are scheduled by milestone. The board is optional curation (WORKING-MODEL §2–3).
    • An issue opened in a component repo is triaged within about a week, then closed or linked to an umbrella issue.
    • RFCs come before cross-cutting ADRs. Small decisions stay in their issue.
    • A PR merges automatically once its required reviews and checks pass, unless it's a draft or carries hold. Before, the page said any approval merges it.
    • Component READMEs say what the component does and link back to the umbrella. Before, the page said each one describes its EBU layer placement, which most don't.
  • Non-claims. All five v0.1 non-claims keep their strength, and "single-node is the proof surface" stays as the boundary.

Refs dmfdeploy/dmfdeploy#688

How it's tested

  • bin/check-voice.sh (from the umbrella) reports 0 errors.
  • The set of links matches main exactly, and every GitHub link and anchor resolves.
  • An adversarial review checked each claim against THESIS, WORKING-MODEL, JOURNEY, the merge workflow and the component READMEs. Its three findings are fixed in this commit.

… facts

Clear every em dash and contrast sentence from the org profile, including
"(enforced, not aspirational)", and keep every link and the EBU
disclaimer word for word.

Two statements now match the working model: milestones schedule issues
(the board is optional curation), and component-repo issues are triaged
within about a week, then closed or linked to an umbrella issue.

Refs dmfdeploy/dmfdeploy#688

Signed-off-by: znerol2 <6800371+znerol2@users.noreply.github.com>
@znerol2
znerol2 requested a review from a team as a code owner October 24, 2026 12:27
@znerol2 znerol2 added the documentation Improvements or additions to documentation label Oct 24, 2026
@znerol2
znerol2 requested a review from lkirc October 24, 2026 12:27
@znerol2 znerol2 changed the title docs(profile): voice-clean the org front page and correct two process facts docs(profile): voice-clean the org front page and correct its process claims Oct 24, 2026

@lkirc lkirc left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thank you much better without all those unfashionable m dashes

@lkirc
lkirc merged commit 6e19e9b into main Oct 24, 2026
1 check passed
@lkirc
lkirc deleted the docs/profile-voice branch October 24, 2026 12:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants