Skip to content

docs: the two settings the reference called broken now work - #252

Merged
jouwdan merged 1 commit into
mainfrom
claude/mei-139-140-docs-followup
Aug 26, 2026
Merged

docs: the two settings the reference called broken now work#252
jouwdan merged 1 commit into
mainfrom
claude/mei-139-140-docs-followup

Conversation

@jouwdan

@jouwdan jouwdan commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

The follow-up I said I'd push. #250 (the administrator reference) and #251 (the fixes) both merged, in that order — so main currently carries three passages documenting bugs the code no longer has.

What was stale

File Said
docs/antispam.md "antispam.moderate_first_posts does not currently hold anything" — with a workaround telling operators to use the per-forum approval switches instead
docs/organiser-guide.md A rule out of Registered "is currently refused … and moves nobody"
docs/groups.md Every unranked group "ranks as 0, so a rule … is passed over as a demotion"

The first two are removed outright — both said "does not currently", and it now does. The table row that pointed at the warning ("Most forum spam — but see the warning below") loses its caveat.

What was kept, rewritten

docs/groups.md's paragraph on the no-demotion guard stays, because the guard still exists and an operator writing a rule needs to know what it refuses. It now describes today's behaviour: a group it does not rank is not compared at all, so a rule into a group you made runs normally, while a move between two ranked groups in the wrong direction is still refused.

It also keeps the sentence worth keeping from the investigation — the rank guard was never what protected staff. A member whose primary group is Banned, Administrators or Super moderators is skipped before any rank is considered. That is the thing an operator should rely on, and it was true before and after the fix.

Verification

docs:links:check (34 documents, 691 headings), docs:index:check and site:docs:check all pass. Grepped for any remaining "does not currently", "is currently refused" or "until this is fixed" across docs/ — none.

Documentation only.


Generated by Claude Code

MEI-139 and MEI-140 landed after the reference that documented them as
defects, so three passages described bugs the code no longer has.

The first-post moderation warning and the promotion warning in the
organiser guide are removed outright — both said "does not currently",
and it now does. The groups reference kept its paragraph on the
no-demotion guard, rewritten to say what the guard does today: a group it
does not rank is not compared at all, so a rule into a group you made runs
normally, and a move between two ranked groups in the wrong direction is
still refused. The line worth keeping from it is that the guard was never
what protected staff — a member in a protected group is skipped before any
rank is considered.
@jouwdan
jouwdan merged commit ce56f1b into main Aug 26, 2026
14 checks 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.

2 participants