Skip to content

content: strip process artifacts from published articles - #29

Merged
foxis merged 1 commit into
mainfrom
fix/content-purity-sweep
Aug 17, 2026
Merged

content: strip process artifacts from published articles#29
foxis merged 1 commit into
mainfrom
fix/content-purity-sweep

Conversation

@foxis

@foxis foxis commented Aug 17, 2026

Copy link
Copy Markdown

Published articles must read as your own first-person work. Several carried leftover production scaffolding, and two of them were visible to readers on the live site.

Reader-visible, worst first

fpv/betaflight-vtx-indexing-trap (both languages) rendered this on the live page:

You disable it on the unit itself — typically a button hold on the VTX... [TODO: confirm the exact TH3 V02 unlock sequence before publish.]

An instruction, followed by a public admission that the instruction was never verified, in an article that shipped.

I did not just delete it. Deleting would leave an unconfirmed claim reading as confirmed, which is worse. Converted into an explicit statement in your voice:

I have not confirmed the exact unlock sequence on my own TH3 V02, so treat the button-hold as the general pattern rather than a recipe, and check your VTX documentation for the specific one.

fpv/drone-detector-nn (both languages) rendered figure placeholders inside the Results section, because they were italic markdown rather than comments:

*[TODO: Training curve — loss and macro F1 across cycles, phase transitions annotated]*
*[TODO: 10×10 confusion matrix]*

Comment blocks

File Removed
meteor75.../index.md DRAFT NOTES FOR ANDRIUS — opened with "delete this comment block before publishing", published anyway. Six items including "still yours to confirm" and "needs your review".
meteor75.../index.lt.md VERTIMO PASTABA + ANDRIUI PERŽIŪRĖTI, including "nesprendžiau nė vieno, palikta tau"
colorimetry/laser-power-meter/index.md <!-- TODO: Add board.jpg -->, <!-- TODO: Add software-ui.jpg -->

I checked the LT note's claim before deleting it

It said the dual-stated numbers were left unresolved. That was stale, not load-bearing:

  • The LT body does carry the resolving section (Metodo pastabos, kurias verta pasiliktiKaip skaityti skaičius)
  • All eleven disputed figures (34.8/34.5, 24.6/24.5, 0.789/0.812, 0.50/0.67, 37.7/38.3, 48.8) appear consistently in both language bodies
  • The stray "wrong for the fifth time" it mentioned existed only inside the comment itself
  • The snake-chart-data.json it referenced lives outside this repo, so no live reference broke

Deliberately left alone

Checked each in context. These are legitimate authorial content, not scaffolding:

  • dml-first-steps"solvable with small mid/high-range speakers on my TODO list" is ordinary prose
  • esp32-as-bluetooth-audio — the # TODO heading is a genuine first-person future-work section
  • edgetx-cockpit-voice-audio-and-sharing"Before publishing a config, check for and scrub" is the subject of the post
  • about/me.lt.md, rate-profiles-persistent-stats.lt.mdperžiūrėti is normal Lithuanian

A blanket regex sweep would have destroyed all four. That's why this was done by inspection.

Verified

  • No process artifacts remain in content prose (frontmatter and fenced code excluded from the scan)
  • All four affected pages render clean in both languages
  • Clean in an unminified build too, not just the minified one CI produces
  • Article bodies otherwise unchanged

Two things still missing, surfaced not hidden

Removing the placeholders does not create the figures:

  1. drone-detector-nn still has no training-curve chart and no confusion matrix, in a section headed "Results and Per-Class Analysis"
  2. laser-power-meter still has no board.jpg and no software-ui.jpg

Send them and I'll add them properly.

Published articles must read as first-person work. Several carried leftover
production scaffolding, two of them visible to readers on the live site.

Removed, both languages where applicable:

1. meteor75-pro-ii-fighting-resonances/index.md — DRAFT NOTES FOR ANDRIUS block,
   which opened with "delete this comment block before publishing" and was
   published anyway. Six numbered items including "still yours to confirm" and
   "needs your review".

2. meteor75-pro-ii-fighting-resonances/index.lt.md — VERTIMO PASTABA and
   ANDRIUI PERŽIŪRĖTI block, including "nesprendžiau nė vieno, palikta tau"
   ("I resolved none of them, left to you").

   Checked before deleting rather than after: the LT note claimed the
   dual-stated numbers were left unresolved, but the LT body does carry the
   resolving section ("Metodo pastabos, kurias verta pasilikti", "Kaip skaityti
   skaičius"), and all eleven disputed figures appear consistently in both
   language bodies. The note was stale, not load-bearing. The stray "wrong for
   the fifth time" it mentioned existed only inside the comment itself, and the
   snake-chart-data.json it referenced lives outside this repo, so no live
   reference broke.

3. colorimetry/laser-power-meter/index.md — two "TODO: Add board.jpg" and
   "TODO: Add software-ui.jpg" comments.

4. fpv/drone-detector-nn, both languages — reader-visible figure placeholders.
   "*[TODO: Training curve ...]*" and "*[TODO: 10x10 confusion matrix]*" were
   italic markdown, not comments, so they rendered on the published page inside
   the Results section. Also removed the paired IMAGE comments.

5. fpv/betaflight-vtx-indexing-trap, both languages — "[TODO: confirm the exact
   TH3 V02 unlock sequence before publish.]" rendered live, publicly admitting
   the instruction above it was unverified.

   Not simply deleted, because deleting it would leave an unconfirmed claim
   reading as confirmed. Converted into an explicit statement in the author's
   voice: the exact unlock sequence was not confirmed on his own unit, so the
   button-hold is the general pattern rather than a recipe.

Deliberately left alone after checking each in context, because they are
legitimate authorial content and not scaffolding:

  - dml-first-steps: "solvable with small mid/high-range speakers on my TODO
    list" is ordinary prose.
  - esp32-as-bluetooth-audio: the "# TODO" heading is a genuine future-work
    section written in first person.
  - edgetx-cockpit-voice-audio-and-sharing: "Before publishing a config, check
    for and scrub" is the subject of the post.
  - about/me.lt.md and rate-profiles-persistent-stats.lt.md: "peržiūrėti" is
    normal Lithuanian prose.

Verified on a local Hugo 0.163.3 build: no artifacts remain in content prose,
all four affected pages render clean in both languages, clean in an unminified
build too, and article bodies are otherwise unchanged.

Two follow-ups for the author, deliberately surfaced rather than hidden:
drone-detector-nn is still missing its training-curve chart and confusion
matrix, and laser-power-meter is still missing board.jpg and software-ui.jpg.
@cursor

cursor Bot commented Aug 17, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@foxis
foxis merged commit d35b1f5 into main Aug 17, 2026
2 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.

1 participant