From 7a947083ab27377f4104dbc65879c2702aaee4b2 Mon Sep 17 00:00:00 2001 From: Michael Assraf Date: Sun, 26 Jul 2026 16:51:54 +0200 Subject: [PATCH] chore: stop ignoring inline doc stubs (.*.md) [preview:none] --- .gitignore | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/.gitignore b/.gitignore index e6af5abd..bb4acd2f 100644 --- a/.gitignore +++ b/.gitignore @@ -32,6 +32,17 @@ coverage.html .DS_Store Thumbs.db -# Generated per-file doc stubs (external doc-orchestrator bot). All documentation -# lives in docs/; these hidden .md files next to source must not be committed. -.*.md +# ┌──────────────────────────────────────────────────────────────────────────┐ +# │ DO NOT ignore hidden `.*.md` files. NEVER re-add a `.*.md` rule here. │ +# └──────────────────────────────────────────────────────────────────────────┘ +# The per-file inline doc stubs written next to source by the Flamingo AI +# Technical Writer ARE first-class source. They are meant to be committed, +# reviewed in the PR, and kept in sync with the code they sit beside. +# +# A `.*.md` rule was added in #212 and had to be reverted: besides discarding +# the docs, it also matched the orchestrator's own run status file +# (`.flamingo-ai-technical-writer-status.md`) and hard-failed every workflow +# run at branch creation before any documentation was generated. +# +# If these files ever feel like noise, fix it upstream in the generator — do +# not silence them here.