[michalharakal]

What

A new Explanation page (Divio quadrant: understanding, not steps): explanation/compile-flexibility.adoc, "Flexibility at every compile stage".

It covers:

• The four stages and their knobs: trace, DAG, StableHLO and IREE. For each stage it lists what can change and who changes it (op author, model author, core, vendor, exporter, IREE). It also shows which TargetOptimizer hooks are wired (dagPasses(), granularity()) and which are only declared (CompilePhase.TAPE, STABLE_HLO).
• Why exact GELU needs care: the exact and tanh forms, the measured 4.73e-4 gap, and the Laya parity requirement.
• What adding the op touched: each layer that feat(ops)!: exact (erf) GELU and erf op (#1342, part 1) #1344 and feat(compile): composite emission seam, GELU legalization pass, @Lowering (#1342, part 2) #1346 changed.
• One op, four ways down:
  • inline chlo.erf
  • the keepFused composite with its decomposition
  • the recorded GeluApproximationLegalizationPass rewrite
  • eager A&S erf
• Eager vs compiled: which checks exist today, and which don't yet (eager vs IREE's chlo.erf; the conformance oracles are still tanh).

Also

• Three self-contained SVGs in images/:
  • stage knobs and hooks
  • the four lowering paths
  • the exact-vs-tanh error curve, computed from the formulas with math.erf
• A nav entry next to "Eager execution".
• A one-line cross-link from the HLO tutorial's composite section, so the how-to stays in the tutorial and the "why" lives here.

Checked

• Every API name, constant and MLIR listing was checked against develop (fd0f6da): GeluLowering, GeluApproximationLegalizationPass, TargetOptimization.kt, OpGranularityPolicy.kt, and 13 converter families in createExtended.
• The Antora site builds with the repo's skainet-antora image, with no warnings. The three images resolve under _images/.
• my-npu and my-dsp are marked as example names, and the Status section says that no shipped target uses the pass or the fused composite yet.

🤖 Generated with Claude Code

[github-actions]

📖 Documentation Preview

The documentation has been built successfully for this PR.

Generated Files:

• Operator documentation: docs/modules/operators/_generated_/
• JSON schema output: operators.json

Artifacts:

• Download the documentation-preview-1432 artifact to view the complete documentation locally.

This comment will be updated automatically when the PR is updated.

[michalharakal]

Pushed 1117a30: the three diagrams now come in light and dark versions.

• Each diagram has a -light.svg and a -dark.svg file. Both are generated from one script, with the same layout in two palettes. The light palette uses the docs UI's own light tokens.
• The page includes both copies with role=only-light / role=only-dark. A 3-line style block in supplemental-ui/partials/footer-scripts.hbs hides the copy that doesn't match the UI bundle's data-theme toggle. If JS is off and the attribute is missing, the light copy shows.
• Fix: the alt texts are now quoted. They contain commas, which AsciiDoc had been reading as width/height attributes.

The Antora build passes with no warnings, and all six SVGs are published under _images/.

🤖 Generated with Claude Code

[github-actions]

📖 Documentation Preview

The documentation has been built successfully for this PR.

Generated Files:

• Operator documentation: docs/modules/operators/_generated_/
• JSON schema output: operators.json

Artifacts:

• Download the documentation-preview-1432 artifact to view the complete documentation locally.

This comment will be updated automatically when the PR is updated.