Skip to content

Add figure and table captions across poscreators/middleware-doc - #81

Open
deboragracio wants to merge 3 commits into
mainfrom
docs-captions-middleware-doc
Open

Add figure and table captions across poscreators/middleware-doc#81
deboragracio wants to merge 3 commits into
mainfrom
docs-captions-middleware-doc

Conversation

@deboragracio

Copy link
Copy Markdown
Collaborator

What

Adds descriptive captions to all images and tables in the poscreators/middleware-doc section — the first batch of a docs-wide captioning effort, scoped small for reviewability.

  • 119 files changed
  • 79 figure captions + 313 table captions added

Convention

  • Format: *Figure N. <description>* / *Table N. <description>* — whole line in italics, placed directly below each element
  • Numbering restarts at 1 per file, with separate figure and table counters, in document order
  • Descriptions are short and generated from each element's content and surrounding context; figures and their companion tables cross-reference each other where relevant

Cleanup included

  • Legacy Word-conversion captions (Illustration N., Tabelle, out-of-order/orphaned numbers) normalized into the new scheme
  • Dead <span id="_Toc…" class="anchor"> bookmarks removed

Intentionally skipped

  • Decorative icons (numbered-circle step markers, in-cell glyphs, store badges)
  • words-in-progress.png placeholder banners and video embeds
  • Code blocks (existing Code N. captions left untouched)

Notes for review

  • general/reference-tables/reference-tables.md is the largest single file (46 tables); captions were derived from section headings.
  • Several BE/ES/GR/PT and DE reference tables are "TBD" placeholders — captioned as to be defined; happy to drop those captions if preferred.

Remaining areas (posdealers, faq, other poscreators) will follow in subsequent batches.

🤖 Generated with Claude Code

@deboragracio
deboragracio requested a review from a team as a code owner August 7, 2026 10:19
Adds italic *Figure N.* / *Table N.* captions directly below every image
and table in the middleware-doc section (119 files: 79 figures, 313
tables). Captions are numbered per file with separate figure/table
counters, and legacy Word-conversion captions (Illustration/Tabelle,
orphaned numbers, dead _Toc anchors) are normalized into the new scheme.

Decorative icons, placeholder banners, video embeds, and code blocks are
intentionally left uncaptioned.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
deboragracio and others added 2 commits August 7, 2026 13:03
The standalone ([click to expand](…)) links duplicated the image already
shown above them and added no value. Removed all 7 in
receipt-sequences-creation.md; the <details>/<summary> collapsibles are
left untouched.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Removes the redundant '(click to expand)' text from 25 collapsible
<details> summaries in single-receipt-creation.md; the collapsible
behaviour is unchanged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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