Skip to content

Write in the first person where a role word described me - #222

Closed
iderex wants to merge 1 commit into
mainfrom
documentation/a-role-word-describes-me-from-outside
Closed

Write in the first person where a role word described me#222
iderex wants to merge 1 commit into
mainfrom
documentation/a-role-word-describes-me-from-outside

Conversation

@iderex

@iderex iderex commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Superseded by #223, and this body is where the reason lives

This pull request carried the change for #220 on a head commit that lacked the
DCO trailer, so the sign-off gate refused it:

FAIL  baed74e25c19a869db8d231cc149a7f975657380 is missing: Signed-off-by: Nils Lehnen <30603423+iderex@users.noreply.github.com>

Read from the run of .github/workflows/dco.yml on that head, 2026-08-31.

The trailer cannot be added to a commit that is already pushed without
rewriting the branch, and a wrong history is repaired by pushing the correction
under a new name and abandoning the old one rather than by a force-push. So the
commit was cherry-picked with the trailer onto
documentation/the-decision-records-report-on-me-from-outside, #223 was opened
from it, and this one is closed.

The content is identical between the two heads, which is the thing worth
checking before abandoning a branch:

git diff baed74e25c19a869db8d231cc149a7f975657380 e719027b2498 --stat
(no output)

Run 2026-08-31. Nothing landed from this branch. What #220 asks for is argued
in full in the body of #223.

What was wrong

Three tracked files described me from outside with a role word. The argument,
the measurements and the run output are in #223 rather than duplicated here.

What this does

Nothing. It is closed unmerged.

Closes

Nothing. #220 is closed by #223.

What was run

The gate was green on this head; what refused it was the DCO check quoted
above, which is a check and not a gate leg.

The means

See #223.

Who read it

Only me. There is no second reader on this board tonight, and this pull request
is closed rather than merged, so nothing reached the mainline from it.

Three tracked files described me from outside instead of saying "I". The text
this project carries is written in the first person, so a word that reports on
me from outside is a defect in the voice rather than a wording preference. The
word is `maintainer`, and it stands here only inside backticks and indented
blocks so that the sentences of this message are themselves in the voice they
are about.

Before, at cfa174a:

    git grep -icl maintainer -- . | wc -l
    3

`decisions/0004` said commits would land in the organisation profile tree from
a source its own holder was not reading. That tree is Flowfin/.github, and its
roster record in the operations tree names one writer:

    git -C G:/Github/operations show origin/main:store/repo/.github.md | sed -n '7,8p'
    Owner: Flowfin
    Writers: iderex

So the sentence was about me and now says so.

`decisions/0006` and `decisions/0008` both handed entry 3 of issue #7 to
somebody named in the third person. That call is mine, and both records now
say so.

Each of the three is a correction that does not change the answer, which
`decisions/README.md` admits as an ordinary edit on a landed record:

    Corrections that do not change the answer are ordinary edits: a broken
    link, a misspelled identifier, a command that has to change because the
    thing it queries moved.

None of the three moves what a reader would decide after reading the record,
so none of them needs a new number and none of them supersedes anything.

After:

    git grep -il maintainer -- . ; echo "exit=$?"
    exit=1

    go run . ci
    7 of 7 legs ran. None was skipped.
@iderex iderex added this to the Decisions of record milestone Aug 31, 2026
@iderex iderex added the documentation Improvements or additions to documentation label Aug 31, 2026
@iderex iderex self-assigned this Aug 31, 2026
@iderex iderex closed this Aug 31, 2026
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.

1 participant