[DawidRobertNowak]

Summary

Docs examples that don't compile on the current QuestPDF, use obsolete APIs, or describe behaviour incorrectly. Every change verified on QuestPDF 2026.9.1.

Wrong or missing names (compile errors)

• Rotate: RotateCounterclockwise / RotateClockwise → RotateLayoutCounterclockwise / RotateLayoutClockwise; table basics: obsolete RotateLeft() replaced.

• Document operations: LayerConfiguration, DocumentAttachment, DocumentAttachmentRelationship, Encryption40Bit/128Bit/256Bit → DocumentOperation.… (nested types, 12 places).

• Units: Unit.Points → Unit.Point; Unit.Millimeters, Unit.Millimeter → Unit.Millimetre; Unit.Centimeter → Unit.Centimetre; Unit.Mill → Unit.Mil (border, column, row, page settings, length units). The units table now lists every unit once and notes the British spelling.

• Generating output: GenerateSvgFiles() → GenerateSvg().

• Debug area: .Debug(...) → .DebugArea(...).

• Components: IContainer.Empty → EmptyContainer.Create(), plus the missing ) before .GeneratePdf(...).

• Style inheritance: container.container.Padding(5) → container.Padding(5).

• Dynamic components: using QuestPDF.Elements; (for DynamicContext) and using System.Globalization; (for CultureInfo).

• Barcodes: the QR example used BarcodeFormat.EAN_13 → BarcodeFormat.QR_CODE.

• Text style, font family: Times New Roman / Courier New are system fonts, not loaded by default since 2026.9, so the example threw → the bundled Noto Serif / JetBrains Mono the tests already use; image regenerated, intro points to font management.

Obsolete APIs

• PdfA = true → PDFA_Conformance = PDFA_Conformance.PDFA_3B (document operations, ZUGFeRD).
• Grid → Column + Row (debug area, image basics, prototyping, document structure ×3), the replacement the obsolete message suggests.
• MinimalBox() → Shrink(); Text(double) → Text($"{…}") (table header and footer).

Misleading text

• SVG: "same scaling options as raster images" → the real options; SVG always keeps its aspect ratio. New "Transparent colors" section: QuestPDF writes #AARRGGBB, the SVG renderer reads #RRGGBBAA, so use fill-opacity in SVG markup; the colors page links to it.
• Layers: additional layers continue across pages but are not repeated on each one (verified); for content on every page, use the page Background / Foreground slots.
• Shadow: blur, spread and offsets are in points, not pixels (rendered: OffsetX = 50 moves the shadow by 100 px at 144 DPI).
• Text basics: the "Download" fallback of the embedded hyperlink PDF pointed to a different file (document-merge-continuous.pdf).
• Text style, Break Anywhere: long words already wrap without it; it changes where lines break (fills lines instead of breaking at / or -).

Check

• Every changed snippet extracted from the pages and compiled against QuestPDF 2026.9.1: 0 errors, 0 warnings; the dynamic-components and components examples also run and produce the expected PDF.
• Grid, MinimalBox and Text(double) replacements render identically to the old code (positions of every rectangle, word and image compared), so the existing example images stay valid.
• Unit conversions in the table measured in a generated PDF (1 in = 72 pt, 1 ft = 864 pt, 1 mil = 0.072 pt, 1 cm = 28.35 pt).
• A scan of all docs pages for type and member names that don't exist in, or are obsolete in, the 2026.9.1 package finds nothing left except the intentionally legacy Previewer page.
• npm run docs:build passes; merges cleanly with main and with Make llms.txt a useful entry point for AI assistants #70.

Why

Found by an AI documentation test: real developer questions answered by AI agents from the docs, every answer compiled. Most failures came from docs snippets like these, and tools that index the docs (e.g. Context7) copy them as they are.

🤖 Generated with Claude Code