canon 0.3.28 → 0.3.29

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6aef461e6f80457ad8fd6c227effe22086b5692f2cfcec5f4226ab0268e4956d
-  data.tar.gz: da2c4ae39e5c8a3483c811fe9bd19c49d69542b637fd97e4b62a2d20fda8bc08
+  metadata.gz: ff4b9d6b5a57176d2d382f7b0d730047161920dfb4cb4004b58d60bba9c0edab
+  data.tar.gz: ed8dfddca4d957fbc3fbb1e62dbd1b03032c661e82c06513304d2abcf4e288cc
 SHA512:
-  metadata.gz: 8cd8327564623711f977aec6b31943433ab962bdec534b2ac107f0eb7ead31cb0854551f3ef614ae1f2e2cdd059b5ac6b3655b44e7cc0dd82d34cff0a2c4b045
-  data.tar.gz: fcaac6df39848f1fd387710e57de61533dac6543028f412b08bd36d9615157a8252a81b13f015606ce666da31d02a5eeea0896abfadafdca6543dc92ac4977c6
+  metadata.gz: 778faacee321541b7d8ceef7c3497969080243acd01fc01bde3902deb68b7664e5ed966a230fc969766cfb32aefe76c81be9d7ae8a86d6b0f0ea870a6ed32cf1
+  data.tar.gz: a3a42291c8100b20362c273c34778abdb4f22eec057c616e54daa60b77e4272c9fe5742fa352874ffc1145c0800e89f6c00800d8938bfcf2af364cff9c71ba9f

data/docs/INDEX.adoc

@@ -140,4 +140,4 @@ See link:contributing[Contributing to Documentation]
 * Configuration profiles with element-level whitespace classification
 * Three-way whitespace sensitivity: strict, normalize, insensitive
 
-See link:https://github.com/lutaml/canon/blob/main/CHANGELOG.md[Full Changelog]
+See link:https://github.com/lutaml/canon/releases[Full Changelog]

data/docs/advanced/diff-classification.adoc

@@ -279,7 +279,7 @@ direction relative to the partner content: `before`, `after`, or
   re-alignment walk encounters an asymmetric whitespace node
 * **Report-only** — does not change equivalence outcomes compared to
   pre-#137 behaviour; only changes the diff-report shape (see
-  link:../features/diff-formatting/whitespace-adjacency.adoc[Whitespace
+  link:../../features/diff-formatting/whitespace-adjacency/[Whitespace
   adjacency] for details)
 
 .Example: Comment handling

data/docs/advanced/extending-canon.adoc

@@ -188,6 +188,6 @@ See the source code for examples of:
 
 == See Also
 
-* link:../understanding/architecture.adoc[Architecture] - 4-layer architecture overview
+* link:../../understanding/architecture/[Architecture] - 4-layer architecture overview
 * link:../features/diff-formatting/[Diff Formatting] - Layer 4 rendering options
 * link:diff-pipeline[Comparison Pipeline] - Technical pipeline details

data/docs/advanced/index.adoc

@@ -19,10 +19,10 @@ This section provides detailed technical information about Canon's internal algo
 
 == What You'll Learn
 
-link:dom-diff-internals[**DOM Diff Internals**]::
+link:../understanding/algorithms/dom-diff/[**DOM Diff**]::
 Deep dive into Canon's default DOM diff algorithm: position-based matching, operation detection, and diff generation.
 
-link:semantic-tree-diff-internals[**Semantic Tree Diff Internals**]::
+link:../understanding/algorithms/semantic-tree-diff/[**Semantic Tree Diff**]::
 How the experimental semantic tree diff works: signature calculation, similarity matching, and operation classification.
 
 link:verbose-mode-architecture[**Verbose Mode Architecture**]::
@@ -57,7 +57,7 @@ The DOM diff algorithm is Canon's stable, well-tested comparison strategy.
 * Performance is critical
 * Stable, predictable behavior required
 
-See link:dom-diff-internals[DOM Diff Internals] for implementation details.
+See link:../understanding/algorithms/dom-diff/[DOM Diff] for implementation details.
 
 === Semantic Tree Diff Algorithm
 
@@ -77,7 +77,7 @@ The semantic tree diff is an experimental algorithm that understands document st
 * Operation-based analysis desired
 * Willing to accept experimental status
 
-See link:semantic-tree-diff-internals[Semantic Tree Diff Internals] for implementation details.
+See link:../understanding/algorithms/semantic-tree-diff/[Semantic Tree Diff Internals] for implementation details.
 
 == Architecture Patterns
 
@@ -203,8 +203,8 @@ result = Canon::Comparison.compare(doc1, doc2,
 
 == Next Steps
 
-* Read link:dom-diff-internals[DOM Diff Internals] to understand the default algorithm
-* Explore link:semantic-tree-diff-internals[Semantic Tree Diff] for advanced matching
+* Read link:../understanding/algorithms/dom-diff/[DOM Diff] to understand the default algorithm
+* Explore link:../understanding/algorithms/semantic-tree-diff/[Semantic Tree Diff] for advanced matching
 * Check link:extending-canon[Extending Canon] to add custom functionality
 
 == See Also

data/docs/advanced/verbose-mode-architecture.adoc

@@ -498,6 +498,6 @@ This ensures the correct output order and separation of concerns.
 == See also
 
 * link:../features/diff-formatting/[Diff Formatting] - Diff output customization
-* link:../understanding/comparison-pipeline.adoc[Comparison Pipeline] - 4-layer architecture
+* link:../../understanding/comparison-pipeline/[Comparison Pipeline] - 4-layer architecture
 * link:../interfaces/rspec/[RSpec Matchers] - Using verbose mode in tests
 * link:../interfaces/cli/[CLI] - Command-line verbose mode

data/docs/features/configuration-profiles.adoc

@@ -280,11 +280,11 @@ Profile YAML keys map directly to Canon configuration accessors:
 |===
 
 All `DiffConfig` and `MatchConfig` attributes documented in
-link:../reference/options-across-interfaces.adoc[Options Across Interfaces]
+link:../../reference/options-across-interfaces/[Options Across Interfaces]
 are supported.
 
 == See also
 
-* link:environment-configuration/override-system.adoc[Override System] -- ENV variable priority
-* link:match-options/index.adoc[Match Options] -- match profile presets (`:strict`, `:spec_friendly`, etc.)
-* link:../guides/choosing-configuration.adoc[Choosing Configuration] -- decision guide
+* link:../environment-configuration/override-system/[Override System] -- ENV variable priority
+* link:../match-options/[Match Options] -- match profile presets (`:strict`, `:spec_friendly`, etc.)
+* link:../../guides/choosing-configuration/[Choosing Configuration] -- decision guide

data/docs/features/diff-formatting/algorithm-specific-output.adoc

@@ -525,9 +525,9 @@ result = Canon::Comparison.equivalent?(doc1, doc2,
 
 == See Also
 
-* link:index.adoc[Diff Formatting Overview]
-* link:diff-modes.adoc[Diff Modes] - by_line vs by_object details
-* link:../match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] - How algorithms work
+* link:../[Diff Formatting Overview]
+* link:../diff-formatting/[Diff modes] - by_line vs by_object details
+* link:../../match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] - How algorithms work
 * link:../../understanding/algorithms/[Algorithms] - Detailed algorithm documentation
-* link:colors-and-symbols.adoc[Colors and Symbols] - Visual formatting options
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Decision guide
+* link:../colors-and-symbols/[Colors and Symbols] - Visual formatting options
+* link:../../../guides/choosing-configuration/[Choosing Configuration] - Decision guide

data/docs/features/diff-formatting/colors-and-symbols.adoc

@@ -480,7 +480,7 @@ Canon supports multiple color themes that adapt the diff display to your termina
 * `:retro` -- Amber CRT, low blue light, accessibility
 * `:claude` -- Claude Code diff style with red/green backgrounds
 
-See link:themes.adoc[Diff display themes] for full theme documentation.
+See link:../themes/[Diff display themes] for full theme documentation.
 
 === Automatic Color Detection
 
@@ -727,9 +727,9 @@ The combination ensures diffs are readable even without color perception.
 
 == Related Features
 
-* link:display-filtering.adoc[Display Filtering] - Control which diff types to show
-* link:context-and-grouping.adoc[Context and Grouping] - Control surrounding context
-* link:../match-options/index.adoc[Match Options] - Configure what's considered normative vs informative
+* link:../display-filtering/[Display Filtering] - Control which diff types to show
+* link:../context-and-grouping/[Context and Grouping] - Control surrounding context
+* link:../../match-options/[Match Options] - Configure what's considered normative vs informative
 
 == See Also
 

data/docs/features/diff-formatting/comment-asymmetry.adoc

@@ -88,7 +88,7 @@ DIFFERENCE #1 — comments: Comment present on EXPECTED only:
 == Combined with whitespace asymmetry
 
 The same realignment walk handles asymmetric whitespace-only text
-nodes (link:whitespace-adjacency.adoc[issue #137]) and asymmetric
+nodes (link:../whitespace-adjacency/[issue #137]) and asymmetric
 comment nodes together. When a children mismatch is fully explained by
 a combination of asymmetric whitespace and asymmetric comments, the
 walker emits one diff per asymmetric node with the appropriate
@@ -147,9 +147,9 @@ Both comparison paths delegate to `ChildRealignment.walk`:
 
 == Related
 
-* link:whitespace-adjacency.adoc[Whitespace adjacency] — sibling
+* link:../whitespace-adjacency/[Whitespace adjacency] — sibling
   contract for asymmetric whitespace-only text nodes.
-* link:../../advanced/diff-classification.adoc[Diff classification] —
+* link:../../../advanced/diff-classification/[Diff classification] —
   Normative vs informative differences.
 
 == History

data/docs/features/diff-formatting/display-filtering.adoc

@@ -507,10 +507,10 @@ puts result.differences.count  # Number of informative diffs
 
 == See also
 
-* link:../match-options/index.adoc[Match options] - Configure match dimensions
-* link:colors-and-symbols.adoc[Colors and symbols] - Understanding diff
+* link:../../match-options/[Match options] - Configure match dimensions
+* link:../colors-and-symbols/[Colors and symbols] - Understanding diff
   visualization
-* link:../../../understanding/algorithms/index.adoc[Diff algorithms] -
+* link:../../../understanding/algorithms/[Diff algorithms] -
   Algorithm-specific behavior
-* link:../../../advanced/diff-classification.adoc[Diff classification] -
+* link:../../../advanced/diff-classification/[Diff classification] -
   Normative vs informative classification

data/docs/features/diff-formatting/display-preprocessing.adoc

@@ -11,7 +11,7 @@ nav_order: 6
 
 Display preprocessing controls how documents are normalized *before the
 line-by-line diff is rendered*. It is entirely separate from
-link:../../features/match-options/index.adoc[comparison preprocessing]
+link:../../match-options/[comparison preprocessing]
 (`FormatConfig#preprocessing`), which controls normalization for equivalence
 detection.
 
@@ -588,7 +588,7 @@ solve an asymmetric formatting problem: fixture files are typically
 hand-indented heredocs, while received XML is compact.
 
 For the full rationale, algorithm, and examples see the dedicated guide:
-link:../match-options/pretty-printed-fixtures.adoc[Pretty-printed fixture support].
+link:../../match-options/pretty-printed-fixtures/[Pretty-printed fixture support].
 
 === Quick reference
 
@@ -644,13 +644,13 @@ described in <<_controlling_whitespace_visualization_with_element_classification
 
 == See also
 
-* link:character-visualization.adoc[Character visualization] — how special
+* link:../character-visualization/[Character visualization] — how special
   characters are rendered in diff output
-* link:../match-options/pretty-printed-fixtures.adoc[Pretty-printed fixture support]
+* link:../../match-options/pretty-printed-fixtures/[Pretty-printed fixture support]
   — full rationale, algorithm, and walkthrough examples
-* link:../../reference/options-across-interfaces.adoc[Options across interfaces]
+* link:../../../reference/options-across-interfaces/[Options across interfaces]
   — Layer 1b display preprocessing table
-* link:../../reference/environment-variables.adoc[Environment variables] —
+* link:../../../reference/environment-variables/[Environment variables] —
   `CANON_DISPLAY_PREPROCESSING` etc.
-* link:../match-options/index.adoc[Match options] — comparison preprocessing
+* link:../../match-options/[Match options] — comparison preprocessing
   (`cfg.xml.preprocessing`)

data/docs/features/diff-formatting/index.adoc

@@ -32,7 +32,7 @@ Canon's diff formatting includes:
   themselves instead of cascading into mismatches against neighbouring
   content. The Reason line names the direction relative to the partner
   (`before`/`after`/`adjacent to`)
-  (link:./whitespace-adjacency.adoc[details])
+  (link:whitespace-adjacency/[details])
 
 == Available formatting options
 
@@ -45,7 +45,7 @@ determination.
 * Show only normative differences (affect equivalence)
 * Show only informative differences (don't affect equivalence)
 
-See link:display-filtering.adoc[Display filtering] for complete details.
+See link:display-filtering/[Display filtering] for complete details.
 
 === Colors and symbols
 
@@ -56,7 +56,7 @@ Canon uses color-coded output to distinguish different types of changes:
 * Yellow: Normative structural changes
 * Cyan: Informative differences
 
-See link:colors-and-symbols.adoc[Colors and symbols] for details.
+See link:colors-and-symbols/[Colors and symbols] for details.
 
 === Diff display themes
 
@@ -67,7 +67,7 @@ Choose from 4 predefined color themes (light, dark, retro, claude) or create cus
 * Retro theme: Amber CRT, low blue light
 * Claude theme: Maximum contrast with colored backgrounds
 
-See link:themes.adoc[Themes] for complete theme documentation.
+See link:themes/[Themes] for complete theme documentation.
 
 === Character visualization
 
@@ -90,7 +90,7 @@ Canon::Config.configure do |cfg|
 end
 ----
 
-See link:character-visualization.adoc[Character visualization] for details.
+See link:character-visualization/[Character visualization] for details.
 
 === Context and grouping
 
@@ -99,7 +99,7 @@ Control how much surrounding context to show:
 * Context lines: Number of unchanged lines around changes
 * Grouping: Combine nearby changes into single blocks
 
-See link:context-and-grouping.adoc[Context and grouping] for details.
+See link:context-and-grouping/[Context and grouping] for details.
 
 === Display preprocessing
 
@@ -111,7 +111,7 @@ algorithm:
 * `:pretty_print` — run through `Canon::PrettyPrinter::Xml` (one tag per line)
 * `:c14n` — run through XML C14N normalization
 
-See link:display-preprocessing.adoc[Display preprocessing] for details,
+See link:display-preprocessing/[Display preprocessing] for details,
 including the character-visualization constraint for future extensibility.
 
 === Pretty-diff mode
@@ -133,7 +133,7 @@ formatter = Canon::DiffFormatter.new(
 )
 ----
 
-See link:pretty-diff-mode.adoc[Pretty-diff mode] for details and limitations.
+See link:pretty-diff-mode/[Pretty-diff mode] for details and limitations.
 
 === Algorithm-specific output
 
@@ -142,7 +142,7 @@ Different diff algorithms produce different output styles:
 * DOM diff: Line-by-line or by-object output
 * Semantic tree diff: Operation-based output with tree structure
 
-See link:algorithm-specific-output.adoc[Algorithm-specific output] for details.
+See link:algorithm-specific-output/[Algorithm-specific output] for details.
 
 == Common use cases
 
@@ -189,16 +189,16 @@ Diff formatting can be configured:
 * Per-format (XML, HTML, JSON, YAML)
 * Per-operation via method parameters
 
-See link:../../reference/cli-options.adoc[CLI options] and
-link:../../interfaces/ruby-api/index.adoc[Ruby API] for configuration details.
+See link:../../reference/cli-options/[CLI options] and
+link:../../interfaces/ruby-api/[Ruby API] for configuration details.
 
 == See also
 
-* link:../../understanding/comparison-pipeline.adoc[Comparison pipeline] -
+* link:../../understanding/comparison-pipeline/[Comparison pipeline] -
   Understanding the diff generation process
-* link:../match-options/index.adoc[Match options] - Controlling what gets
+* link:../match-options/[Match options] - Controlling what gets
   compared
-* link:../../advanced/diff-classification.adoc[Diff classification] -
+* link:../../advanced/diff-classification/[Diff classification] -
   Normative vs informative differences
-* link:../../interfaces/cli/index.adoc[CLI interface] - Command-line usage
-* link:../../interfaces/ruby-api/index.adoc[Ruby API] - Programmatic usage
+* link:../../interfaces/cli/[CLI interface] - Command-line usage
+* link:../../interfaces/ruby-api/[Ruby API] - Programmatic usage

data/docs/features/diff-formatting/pretty-diff-mode.adoc

@@ -94,7 +94,7 @@ For preformatted elements where every whitespace character is significant, use
 `preserve_whitespace_elements` instead (e.g. `%w[pre code]`).
 
 See
-link:display-preprocessing.adoc#_controlling_whitespace_visualization_with_element_classification[display-preprocessing:
+link:../display-preprocessing/#_controlling_whitespace_visualization_with_element_classification[display-preprocessing:
 element classification] for the full three-way classification system and HTML
 format defaults.
 
@@ -146,9 +146,9 @@ to avoid resolving against `Canon::Diff` which is an unrelated internal module.
 
 == See also
 
-* link:display-preprocessing.adoc[Display preprocessing] — normalising input
+* link:../display-preprocessing/[Display preprocessing] — normalising input
   before the diff
-* link:context-and-grouping.adoc[Context and grouping] — context_lines and
+* link:../context-and-grouping/[Context and grouping] — context_lines and
   diff grouping
-* link:display-filtering.adoc[Display filtering] — normative/informative
+* link:../display-filtering/[Display filtering] — normative/informative
   filtering (`:by_line` only)

data/docs/features/diff-formatting/themes.adoc

@@ -347,7 +347,7 @@ Colors `:bright_black` and `:bright_white` are not supported by Rainbow in 16-co
 
 == See also
 
-* link:colors-and-symbols.adoc[Colors and symbols] - Diff markers and classification
-* link:display-filtering.adoc[Display filtering] - Control which diff types appear
+* link:../colors-and-symbols/[Colors and symbols] - Diff markers and classification
+* link:../display-filtering/[Display filtering] - Control which diff types appear
 * link:../environment-configuration/index.html[Environment configuration] - ENV variable setup
 * link:../../reference/environment-variables.html[Environment variables reference] - Complete variable listing

data/docs/features/diff-formatting/whitespace-adjacency.adoc

@@ -110,7 +110,7 @@ information. In that case Canon falls back to naming the parent
 element instead — `Whitespace inside <PARENT>` — and the
 Expected/Actual detail block renders each side's parent element
 compactly per the contract from
-link:../../advanced/semantic-diff-report.adoc#parent-context-fallback-for-ambiguous-text-diffs[issue #112].
+link:../../../advanced/semantic-diff-report/#parent-context-fallback-for-ambiguous-text-diffs[issue #112].
 
 NOTE: An earlier wording (`Whitespace surrounding "X"`) classified the
 *whitespace node's position among its own siblings* rather than its
@@ -212,9 +212,9 @@ whitespace node as a single normative `:whitespace_adjacency` diff.
 
 == Related
 
-* link:../../advanced/diff-classification.adoc[Diff classification] —
+* link:../../../advanced/diff-classification/[Diff classification] —
   Normative vs informative differences.
-* link:../match-options/index.adoc[Match options] — Configuring
+* link:../../match-options/[Match options] — Configuring
   `preserve_whitespace_elements`, `collapse_whitespace_elements`, and
   `strip_whitespace_elements`.
 

data/docs/features/environment-configuration/index.adoc

@@ -120,7 +120,7 @@ export CANON_DIFF_THEME=claude
 
 Valid values: `light`, `dark`, `retro`, `claude`
 
-See link:../diff-formatting/themes.adoc[Diff display themes] for complete theme documentation.
+See link:../diff-formatting/themes/[Diff display themes] for complete theme documentation.
 
 === Context and grouping
 
@@ -162,7 +162,7 @@ Valid values: `true`, `false`, `1`, `0`, `yes`, `no`
 
 Canon provides configurable size limits to prevent hangs or excessive resource usage when processing very large files.
 
-See link:size-limits.adoc[Size Limits] for detailed configuration.
+See link:size-limits/[Size Limits] for detailed configuration.
 
 Key variables:
 
@@ -172,7 +172,7 @@ Key variables:
 
 == Override system
 
-See link:override-system.adoc[Override System] for how environment variables interact with programmatic configuration.
+See link:override-system/[Override System] for how environment variables interact with programmatic configuration.
 
 == Usage across interfaces
 
@@ -307,7 +307,7 @@ export CANON_USE_COLOR=false
 
 == Complete variable reference
 
-See link:../../reference/environment-variables.adoc[Environment Variables Reference] for a complete table of all environment variables.
+See link:../../reference/environment-variables/[Environment Variables Reference] for a complete table of all environment variables.
 
 == Troubleshooting
 
@@ -344,7 +344,7 @@ puts "Source of algorithm: #{resolver.source_for(:algorithm)}"
 
 == See also
 
-* link:size-limits.adoc[Size Limits] - File size and node count limits
-* link:override-system.adoc[Override System] - How ENV vars override defaults
-* link:../../reference/environment-variables.adoc[Environment Variables Reference] - Complete variable listing
-* link:../../reference/options-across-interfaces.adoc[Options Across Interfaces] - How options map across CLI, Ruby, and RSpec
+* link:size-limits/[Size Limits] - File size and node count limits
+* link:override-system/[Override System] - How ENV vars override defaults
+* link:../../reference/environment-variables/[Environment Variables Reference] - Complete variable listing
+* link:../../reference/options-across-interfaces/[Options Across Interfaces] - How options map across CLI, Ruby, and RSpec

data/docs/features/environment-configuration/override-system.adoc

@@ -43,7 +43,7 @@ Configuration values are resolved using a strict four-level priority:
 
 **Rule**: Higher priority always wins, regardless of when values are set.
 
-See link:../configuration-profiles.adoc[Configuration Profiles] for details on the profile layer.
+See link:../../configuration-profiles/[Configuration Profiles] for details on the profile layer.
 
 == How overrides work
 
@@ -437,7 +437,7 @@ end
 
 == See also
 
-* link:index.adoc[Environment Configuration] - Overview and usage
-* link:size-limits.adoc[Size Limits] - Limit-specific ENV variables
-* link:../../reference/environment-variables.adoc[Environment Variables Reference] - Complete listing
-* link:../../reference/options-across-interfaces.adoc[Options Across Interfaces] - How options work in CLI, Ruby, RSpec
+* link:../[Environment Configuration] - Overview and usage
+* link:../size-limits/[Size Limits] - Limit-specific ENV variables
+* link:../../../reference/environment-variables/[Environment Variables Reference] - Complete listing
+* link:../../../reference/options-across-interfaces/[Options Across Interfaces] - How options work in CLI, Ruby, RSpec

data/docs/features/environment-configuration/size-limits.adoc

@@ -267,7 +267,7 @@ export CANON_VERBOSE_DIFF=false
 
 == See also
 
-* link:index.adoc[Environment Configuration] - Complete ENV configuration
-* link:override-system.adoc[Override System] - How ENV vars work
-* link:../../reference/environment-variables.adoc[Environment Variables Reference] - All variables
-* link:../../understanding/algorithms/dom-diff.adoc[DOM Algorithm] - Faster for large files
+* link:../[Environment Configuration] - Complete ENV configuration
+* link:../override-system/[Override System] - How ENV vars work
+* link:../../../reference/environment-variables/[Environment Variables Reference] - All variables
+* link:../../../understanding/algorithms/dom-diff/[DOM Algorithm] - Faster for large files

data/docs/features/index.adoc

@@ -79,7 +79,7 @@ Customize how differences are displayed.
 
 === Configuration Profiles
 
-link:configuration-profiles.adoc[**Configuration Profiles**]::
+link:configuration-profiles/[**Configuration Profiles**]::
 Bundle all settings into named presets defined in YAML.
 +
 * Built-in profiles (metanorma, metanorma_debug)

data/docs/features/match-options/algorithm-specific-behavior.adoc

@@ -357,9 +357,9 @@ end
 
 == See Also
 
-* link:index.adoc[Match Options Overview]
+* link:../[Match Options Overview]
 * link:../../understanding/algorithms/[Algorithms] - Detailed algorithm documentation
-* link:dimensions.adoc[Match Dimensions] - All available dimensions
-* link:profiles.adoc[Match Profiles] - Preset configurations
-* link:../diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output] - How output differs
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Decision guide
+* link:../match-options/[Match dimensions] - All available dimensions
+* link:../match-options/[Match profiles] - Preset configurations
+* link:../../diff-formatting/algorithm-specific-output/[Algorithm-Specific Output] - How output differs
+* link:../../../guides/choosing-configuration/[Choosing Configuration] - Decision guide

data/docs/features/match-options/html-policies.adoc

@@ -314,4 +314,4 @@ See the following files for implementation details:
 
 * link:index.html[Match Options] - Overview of match system
 * link:algorithm-specific-behavior.html[Algorithm-Specific Behavior] - How algorithms handle options
-* link:../../advanced/diff-classification.html[Diff Classification] - Normative vs informative
+* link:../../../advanced/diff-classification/[Diff Classification] - Normative vs informative

data/docs/features/match-options/index.adoc

@@ -12,7 +12,7 @@ has_children: true
 
 This section provides a complete reference for Canon's match options, including match dimensions, behaviors, and predefined profiles.
 
-Match options control **Layer 3 (Match Options)** of Canon's 4-layer comparison architecture. See link:../../understanding/comparison-pipeline.adoc[Comparison Pipeline] for the complete flow.
+Match options control **Layer 3 (Match Options)** of Canon's 4-layer comparison architecture. See link:../../understanding/comparison-pipeline/[Comparison Pipeline] for the complete flow.
 
 == Overview
 
@@ -22,15 +22,15 @@ Match options control which aspects of documents are compared and how strictly t
 * **Dimension behaviors**: How each dimension is compared (`:strict`, `:normalize`, `:ignore`)
 * **Match profiles**: Predefined combinations for common scenarios
 
-**Important**: Match options behave differently with each algorithm. See link:algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] for details.
+**Important**: Match options behave differently with each algorithm. See link:algorithm-specific-behavior/[Algorithm-Specific Behavior] for details.
 
 == Child Pages
 
-* link:dimensions.adoc[Match Dimensions] - Detailed reference for all dimensions
-* link:profiles.adoc[Match Profiles] - Predefined configurations
-* link:algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] - How DOM and Semantic algorithms interpret options differently
-* link:html-policies.adoc[HTML-Specific Policies] - HTML format-specific comparison policies
-* link:pretty-printed-fixtures.adoc[Pretty-Printed Fixture Support] - Comparing compact generated XML against hand-indented fixture heredocs without spurious whitespace differences
+* link:../match-options/[Match dimensions] - Detailed reference for all dimensions
+* link:../match-options/[Match profiles] - Predefined configurations
+* link:algorithm-specific-behavior/[Algorithm-Specific Behavior] - How DOM and Semantic algorithms interpret options differently
+* link:html-policies/[HTML-Specific Policies] - HTML format-specific comparison policies
+* link:pretty-printed-fixtures/[Pretty-Printed Fixture Support] - Comparing compact generated XML against hand-indented fixture heredocs without spurious whitespace differences
 
 == Match dimensions overview
 

data/docs/features/match-options/pretty-printed-fixtures.adoc

@@ -261,10 +261,10 @@ new code.
 
 == See also
 
-* link:../../features/diff-formatting/display-preprocessing.adoc[Display preprocessing]
+* link:../../diff-formatting/display-preprocessing/[Display preprocessing]
   — the `display_preprocessing` option and `XmlNormalized` serializer
-* link:index.adoc[Match options overview] — whitespace sensitivity classification
-* link:../../reference/options-across-interfaces.adoc[Options across interfaces]
+* link:../[Match options overview] — whitespace sensitivity classification
+* link:../../../reference/options-across-interfaces/[Options across interfaces]
   — cross-interface reference table
-* link:../../reference/environment-variables.adoc[Environment variables]
+* link:../../../reference/environment-variables/[Environment variables]
   — `CANON_XML_DIFF_PRETTY_PRINTED_EXPECTED`, `CANON_XML_DIFF_PRETTY_PRINTED_RECEIVED`

data/docs/guides/choosing-configuration.adoc

@@ -216,7 +216,7 @@ Canon::Comparison.equivalent?(doc1, doc2,
 )
 ----
 
-**Remember**: Match options behave differently with each algorithm! See link:../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior].
+**Remember**: Match options behave differently with each algorithm! See link:../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior].
 
 ==== Whitespace Type Sensitivity
 
@@ -709,14 +709,14 @@ Profiles bundle all layers (preprocessing, match profile, diff settings,
 whitespace element lists) into a named preset defined in YAML.
 Custom file profiles can inherit from built-in profiles.
 
-See link:../features/configuration-profiles.adoc[Configuration Profiles] for full documentation.
+See link:../../features/configuration-profiles/[Configuration Profiles] for full documentation.
 
 == See Also
 
-* link:../features/configuration-profiles.adoc[Configuration Profiles] - Named config presets
-* link:../understanding/comparison-pipeline.adoc[Comparison Pipeline] - Understanding the 4 layers
+* link:../../features/configuration-profiles/[Configuration Profiles] - Named config presets
+* link:../../understanding/comparison-pipeline/[Comparison Pipeline] - Understanding the 4 layers
 * link:../understanding/algorithms/[Algorithms] - Detailed algorithm documentation
-* link:../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] - How algorithms differ
-* link:../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output] - Output format differences
+* link:../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] - How algorithms differ
+* link:../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output] - Output format differences
 * link:../features/match-options/[Match Options] - All matching options
 * link:../features/diff-formatting/[Diff Formatting] - Formatting options

data/docs/interfaces/rspec/index.adoc

@@ -428,7 +428,7 @@ IMPORTANT: Display filtering does NOT affect equivalence determination. It
 only controls which differences appear in the failure output. Equivalence is
 always based on normative differences only.
 
-See link:../../features/diff-formatting/display-filtering.adoc[Display
+See link:../../features/diff-formatting/display-filtering/[Display
 filtering] for complete details.
 
 == Diff algorithms

data/docs/interfaces/ruby-api/index.adoc

@@ -545,7 +545,7 @@ result = Canon::Comparison.equivalent?(xml1, xml2,
 ----
 ====
 
-See link:../../features/diff-formatting/display-filtering.adoc[Display
+See link:../../features/diff-formatting/display-filtering/[Display
 filtering] for complete details.
 
 === Format-specific comparators

data/docs/internals/diffnode-enrichment.adoc

@@ -606,7 +606,7 @@ The old API still works for backwards compatibility, but enriched properties pro
 
 == See also
 
-* link:../understanding/architecture.adoc[Architecture] - 4-layer architecture overview
+* link:../../understanding/architecture/[Architecture] - 4-layer architecture overview
 * link:../understanding/algorithms/[Algorithms] - DOM and Semantic algorithm details
 * link:../features/diff-formatting/[Diff Formatting] - Layer 4 rendering options
 * link:diff-char-range-pipeline[DiffCharRange Pipeline] - How enriched DiffNodes are processed into character-level display positions

data/docs/internals/index.adoc

@@ -71,7 +71,7 @@ Canon separates comparison concerns into four layers:
 
 Only Layer 2 differs between algorithms, and the enriched DiffNode structure ensures clean communication between layers.
 
-See link:../understanding/architecture.adoc[Architecture] for the complete overview.
+See link:../understanding/architecture/[Architecture] for the complete overview.
 
 === Enriched Metadata Flow
 
@@ -265,7 +265,7 @@ def add_difference(node1, node2, diff1, diff2, dimension, opts, differences)
 end
 ----
 
-See link:../understanding/algorithms/dom-diff.adoc[DOM Diff Algorithm] for details.
+See link:../understanding/algorithms/dom-diff/[DOM Diff Algorithm] for details.
 
 === Semantic Algorithm
 
@@ -289,11 +289,11 @@ def convert_insert(operation)
 end
 ----
 
-See link:../understanding/algorithms/semantic-tree-diff.adoc[Semantic Tree Diff Algorithm] for details.
+See link:../understanding/algorithms/semantic-tree-diff/[Semantic Tree Diff Algorithm] for details.
 
 == See Also
 
-* link:../understanding/architecture.adoc[Architecture] - 4-layer architecture overview
+* link:../understanding/architecture/[Architecture] - 4-layer architecture overview
 * link:../understanding/algorithms/[Algorithms] - DOM and Semantic algorithm details
 * link:../features/diff-formatting/[Diff Formatting] - Layer 4 rendering options
 * link:../advanced/[Advanced Topics] - Deep technical documentation

data/docs/reference/cli-options.adoc

@@ -11,9 +11,9 @@ nav_order: 1
 
 This page provides a complete reference for all Canon command-line interface options organized by command and function.
 
-For conceptual understanding, see link:../understanding/comparison-pipeline.adoc[Comparison Pipeline].
+For conceptual understanding, see link:../../understanding/comparison-pipeline/[Comparison Pipeline].
 
-For choosing the right configuration, see link:../guides/choosing-configuration.adoc[Choosing Configuration].
+For choosing the right configuration, see link:../../guides/choosing-configuration/[Choosing Configuration].
 
 == Command syntax
 
@@ -413,8 +413,8 @@ canon diff page1.html page2.html \
 
 == See also
 
-* link:../understanding/comparison-pipeline.adoc[Comparison Pipeline] - 4-layer architecture
-* link:../guides/choosing-configuration.adoc[Choosing Configuration] - Decision guide
+* link:../../understanding/comparison-pipeline/[Comparison Pipeline] - 4-layer architecture
+* link:../../guides/choosing-configuration/[Choosing Configuration] - Decision guide
 * link:../features/match-options/[Match Options] - Dimension reference
 * link:../features/diff-formatting/[Diff Formatting] - Output customization
 * link:../interfaces/cli/[CLI Interface] - Command-line usage guide

data/docs/reference/environment-variables.adoc

@@ -128,7 +128,7 @@ export CANON_JSON_FORMAT_PREPROCESSING=normalize
 |`CANON_XML_DIFF_PRETTY_PRINTED_EXPECTED`
 |boolean
 |`false`
-|When `true`, whitespace-only text nodes that start with `"\n"` inside `:collapse`-classified elements are dropped from the **expected (fixture)** document before it reaches the line diff.  Solves the asymmetric case where the expected side is a hand-indented heredoc fixture but the received side is compact programmatic XML.  Only applies when `display_preprocessing: :normalize_pretty_print`.  Format-specific; no global form.  See also link:../features/match-options/pretty-printed-fixtures.adoc[Pretty-printed fixture support].
+|When `true`, whitespace-only text nodes that start with `"\n"` inside `:collapse`-classified elements are dropped from the **expected (fixture)** document before it reaches the line diff.  Solves the asymmetric case where the expected side is a hand-indented heredoc fixture but the received side is compact programmatic XML.  Only applies when `display_preprocessing: :normalize_pretty_print`.  Format-specific; no global form.  See also link:../../features/match-options/pretty-printed-fixtures/[Pretty-printed fixture support].
 |XML (display only)
 
 |`CANON_XML_DIFF_PRETTY_PRINTED_RECEIVED`

data/docs/understanding/algorithms/dom-diff.adoc

@@ -174,7 +174,7 @@ Canon::Comparison.equivalent?(doc1, doc2,
 )
 ----
 
-See link:../../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] for how DOM interprets match options.
+See link:../../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] for how DOM interprets match options.
 
 === With Diff Formatting
 
@@ -289,7 +289,7 @@ The DOM algorithm cannot detect when content moves to a different position:
 
 **Limitation**: Reordered content shows as DELETE + INSERT pairs
 
-**Workaround**: Use link:semantic-tree-diff.adoc[Semantic Algorithm] for move detection
+**Workaround**: Use link:../semantic-tree-diff/[Semantic Algorithm] for move detection
 
 === Position-Dependent
 
@@ -297,7 +297,7 @@ The algorithm assumes similar structure between documents:
 
 **Limitation**: Heavily restructured documents produce noisy diffs
 
-**Workaround**: Use link:semantic-tree-diff.adoc[Semantic Algorithm] for restructured documents
+**Workaround**: Use link:../semantic-tree-diff/[Semantic Algorithm] for restructured documents
 
 == Common Use Cases
 
@@ -381,9 +381,9 @@ Canon::Comparison.equivalent?(html1, html2,
 
 == See Also
 
-* link:index.adoc[Algorithms Overview] - Comparison of DOM vs Semantic
-* link:semantic-tree-diff.adoc[Semantic Algorithm] - Alternative algorithm
-* link:../../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] - How DOM interprets options
-* link:../../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output] - Output format details
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Complete decision guide
-* link:../../advanced/dom-diff-internals.adoc[DOM Diff Internals] - Advanced implementation details (if available)
+* link:../[Algorithms Overview] - Comparison of DOM vs Semantic
+* link:../semantic-tree-diff/[Semantic Algorithm] - Alternative algorithm
+* link:../../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] - How DOM interprets options
+* link:../../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output] - Output format details
+* link:../../../guides/choosing-configuration/[Choosing Configuration] - Complete decision guide
+* link:../dom-diff/[DOM Diff] - Implementation details

data/docs/understanding/algorithms/index.adoc

@@ -12,7 +12,7 @@ has_children: true
 
 Canon provides two comparison algorithms, each with different strengths and use cases. This section explains how to choose between them and what to expect from each.
 
-This corresponds to **Layer 2 (Algorithm Selection)** in Canon's 4-layer architecture. See link:../comparison-pipeline.adoc[Comparison Pipeline] for the complete flow.
+This corresponds to **Layer 2 (Algorithm Selection)** in Canon's 4-layer architecture. See link:../comparison-pipeline/[Comparison Pipeline] for the complete flow.
 
 == Overview
 
@@ -21,12 +21,12 @@ Canon supports two algorithms for document comparison:
 * **DOM Algorithm** - Fast, stable, positional comparison (default)
 * **Semantic Algorithm** - Slower, intelligent, detects moves and restructuring (experimental)
 
-**Critical**: The algorithm choice affects how Layers 3 and 4 behave. See link:../../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] and link:../../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output].
+**Critical**: The algorithm choice affects how Layers 3 and 4 behave. See link:../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] and link:../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output].
 
 == Child Pages
 
-* link:dom-diff.adoc[DOM Algorithm] - Positional comparison details
-* link:semantic-tree-diff.adoc[Semantic Algorithm] - Tree-based comparison details
+* link:dom-diff/[DOM Algorithm] - Positional comparison details
+* link:semantic-tree-diff/[Semantic Algorithm] - Tree-based comparison details
 
 == Algorithm Comparison
 
@@ -249,7 +249,7 @@ NOTE: These are approximate times. Actual performance depends on document struct
 3. Performance slower but more intelligent
 4. Output format changes to operation-based
 
-See link:../../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] for migration details.
+See link:../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] for migration details.
 
 === Switching from Semantic to DOM
 
@@ -306,9 +306,9 @@ end
 
 == See also
 
-* link:dom-diff.adoc[DOM Algorithm] - Detailed DOM algorithm documentation
-* link:semantic-tree-diff.adoc[Semantic Algorithm] - Detailed semantic algorithm documentation
-* link:../comparison-pipeline.adoc[Comparison Pipeline] - 4-layer architecture
-* link:../../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] - How algorithms interpret options
-* link:../../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output] - Output format differences
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Complete decision guide
+* link:dom-diff/[DOM Algorithm] - Detailed DOM algorithm documentation
+* link:semantic-tree-diff/[Semantic Algorithm] - Detailed semantic algorithm documentation
+* link:../comparison-pipeline/[Comparison Pipeline] - 4-layer architecture
+* link:../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] - How algorithms interpret options
+* link:../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output] - Output format differences
+* link:../../guides/choosing-configuration/[Choosing Configuration] - Complete decision guide

data/docs/understanding/algorithms/semantic-tree-diff.adoc

@@ -230,7 +230,7 @@ Canon::Comparison.equivalent?(doc1, doc2,
 )
 ----
 
-See link:../../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] for details.
+See link:../../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] for details.
 
 === With Diff Formatting
 
@@ -525,9 +525,9 @@ When switching from DOM to Semantic:
 
 == See Also
 
-* link:index.adoc[Algorithms Overview] - Comparison of DOM vs Semantic
-* link:dom-diff.adoc[DOM Algorithm] - Standard algorithm
-* link:../../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] - How Semantic interprets options
-* link:../../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output] - Output format details
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Complete decision guide
-* link:../../advanced/semantic-tree-diff-internals.adoc[Semantic Tree Diff Internals] - Advanced details (if available)
+* link:../[Algorithms Overview] - Comparison of DOM vs Semantic
+* link:../dom-diff/[DOM Algorithm] - Standard algorithm
+* link:../../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] - How Semantic interprets options
+* link:../../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output] - Output format details
+* link:../../../guides/choosing-configuration/[Choosing Configuration] - Complete decision guide
+* link:../semantic-tree-diff/[Semantic Tree Diff] - Advanced details

data/docs/understanding/architecture.adoc

@@ -11,9 +11,9 @@ nav_order: 1
 
 This document explains Canon's 4-layer comparison architecture and how documents flow through preprocessing, algorithm selection, semantic matching, and diff rendering.
 
-For a guided walkthrough of choosing configurations, see link:../guides/choosing-configuration.adoc[Choosing Configuration].
+For a guided walkthrough of choosing configurations, see link:../../guides/choosing-configuration/[Choosing Configuration].
 
-For detailed 4-layer pipeline documentation, see link:comparison-pipeline.adoc[Comparison Pipeline].
+For detailed 4-layer pipeline documentation, see link:../comparison-pipeline/[Comparison Pipeline].
 
 == Overview
 
@@ -799,7 +799,7 @@ Control how differences are displayed. **This layer is algorithm-specific** - ea
 * **DOM algorithm**: Generates line-based differences
 * **Semantic algorithm**: Generates operation-based differences (INSERT, DELETE, UPDATE, MOVE)
 
-See link:../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output] for detailed comparison.
+See link:../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output] for detailed comparison.
 
 === Diff options
 
@@ -865,7 +865,7 @@ result = Canon::Comparison.equivalent?(doc1, doc2,
 )
 ----
 
-See link:comparison-pipeline.adoc[Comparison Pipeline] for layer-by-layer examples.
+See link:../comparison-pipeline/[Comparison Pipeline] for layer-by-layer examples.
 
 === DiffNode: Representation of differences
 
@@ -1153,16 +1153,16 @@ This refactoring improves:
 
 == See also
 
-* link:comparison-pipeline.adoc[Comparison Pipeline] - Complete 4-layer walkthrough
+* link:../comparison-pipeline/[Comparison Pipeline] - Complete 4-layer walkthrough
 * link:algorithms/[Algorithms] - DOM and Semantic algorithm details
 * link:../internals/[Internals] - Implementation details and data structures
-* link:../internals/diffnode-enrichment.adoc[DiffNode Enrichment] - How metadata flows from Layer 2 to Layer 4
+* link:../../internals/diffnode-enrichment/[DiffNode Enrichment] - How metadata flows from Layer 2 to Layer 4
 * link:../features/preprocessing/[Preprocessing options]
 * link:../features/match-options/[Match dimensions and profiles]
-* link:../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior]
+* link:../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior]
 * link:../features/diff-formatting/[Diff formatting]
-* link:../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output]
-* link:../guides/choosing-configuration.adoc[Choosing Configuration]
+* link:../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output]
+* link:../../guides/choosing-configuration/[Choosing Configuration]
 * link:../interfaces/ruby-api/[Ruby API documentation]
 * link:../interfaces/cli/[Command-line interface]
 * link:../interfaces/rspec/[RSpec matchers]

data/docs/understanding/comparison-pipeline.adoc

@@ -67,7 +67,7 @@ graph TD
 * Match profiles (preset combinations)
 * Algorithm-specific behaviors
 
-**Documentation**: See link:../features/match-options/[Match Options] and link:../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior]
+**Documentation**: See link:../features/match-options/[Match Options] and link:../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior]
 
 === Layer 4: Diff Formatting
 
@@ -81,7 +81,7 @@ graph TD
 * Context and grouping
 * Character visualization
 
-**Documentation**: See link:../features/diff-formatting/[Diff Formatting] and link:../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output]
+**Documentation**: See link:../features/diff-formatting/[Diff Formatting] and link:../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output]
 
 == DiffNode Data Flow
 
@@ -154,7 +154,7 @@ After creation, DiffNodes are enriched with metadata for Layer 4 rendering:
 * **NodeSerializer**: Library-agnostic serialization of node content
 * **Attribute extraction**: Normalized attribute hashes
 
-See link:../internals/diffnode-enrichment.adoc[DiffNode Enrichment] for implementation details.
+See link:../../internals/diffnode-enrichment/[DiffNode Enrichment] for implementation details.
 
 === Layer 3: Classification
 
@@ -432,8 +432,8 @@ Canon::Comparison.equivalent?(doc1, doc2,
 
 == See Also
 
-* link:architecture.adoc[Architecture] - Overall system design
+* link:../architecture/[Architecture] - Overall system design
 * link:algorithms/[Algorithms] - Detailed algorithm documentation
-* link:../features/match-options/algorithm-specific-behavior.adoc[Algorithm-Specific Behavior] - How algorithms interpret match options
-* link:../features/diff-formatting/algorithm-specific-output.adoc[Algorithm-Specific Output] - Different output formats
-* link:../guides/choosing-configuration.adoc[Choosing Configuration] - Decision guide for all layers
+* link:../../features/match-options/algorithm-specific-behavior/[Algorithm-Specific Behavior] - How algorithms interpret match options
+* link:../../features/diff-formatting/algorithm-specific-output/[Algorithm-Specific Output] - Different output formats
+* link:../../guides/choosing-configuration/[Choosing Configuration] - Decision guide for all layers

data/docs/understanding/formats/html.adoc

@@ -396,9 +396,9 @@ XHTML is treated as XML and follows stricter rules.
 
 == See also
 
-* link:../comparison-pipeline.adoc[Comparison Pipeline] - Understanding the 4 layers
+* link:../../comparison-pipeline/[Comparison Pipeline] - Understanding the 4 layers
 * link:../../features/match-options/[Match Options] - All matching options
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Decision guide
-* link:index.adoc[Format Support] - Overview of all formats
-* link:xml.adoc[XML Format] - XML-specific features
-* link:json.adoc[JSON Format] - JSON-specific features
+* link:../../../guides/choosing-configuration/[Choosing Configuration] - Decision guide
+* link:../[Format Support] - Overview of all formats
+* link:../xml/[XML Format] - XML-specific features
+* link:../json/[JSON Format] - JSON-specific features

data/docs/understanding/formats/index.adoc

@@ -20,10 +20,10 @@ Canon provides unified canonicalization and comparison for four serialization fo
 
 This page provides an overview of format support. See the child pages for format-specific details:
 
-* link:xml.adoc[XML Format] - W3C C14N, namespace handling
-* link:html.adoc[HTML Format] - HTML4/5 detection, rendering behavior
-* link:json.adoc[JSON Format] - Sorted keys, type preservation
-* link:yaml.adoc[YAML Format] - YAML specifics, anchors and aliases
+* link:xml/[XML Format] - W3C C14N, namespace handling
+* link:html/[HTML Format] - HTML4/5 detection, rendering behavior
+* link:json/[JSON Format] - Sorted keys, type preservation
+* link:yaml/[YAML Format] - YAML specifics, anchors and aliases
 
 == Format detection
 
@@ -257,5 +257,5 @@ Canon::Comparison::YamlComparator.equivalent?(yaml1, yaml2,
 * link:../../interfaces/ruby-api/[Ruby API documentation]
 * link:../../interfaces/cli/[Command-line interface]
 * link:../../features/match-options/[Match options reference]
-* link:../comparison-pipeline.adoc[Comparison Pipeline]
+* link:../comparison-pipeline/[Comparison Pipeline]
 * link:../../features/preprocessing/[Preprocessing options]

data/docs/understanding/formats/json.adoc

@@ -382,9 +382,9 @@ Canon normalizes Unicode escapes during canonicalization.
 
 == See also
 
-* link:../comparison-pipeline.adoc[Comparison Pipeline] - Understanding the 4 layers
+* link:../../comparison-pipeline/[Comparison Pipeline] - Understanding the 4 layers
 * link:../../features/match-options/[Match Options] - All matching options
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Decision guide
-* link:index.adoc[Format Support] - Overview of all formats
-* link:yaml.adoc[YAML Format] - YAML-specific features (similar to JSON)
-* link:xml.adoc[XML Format] - XML-specific features
+* link:../../../guides/choosing-configuration/[Choosing Configuration] - Decision guide
+* link:../[Format Support] - Overview of all formats
+* link:../yaml/[YAML Format] - YAML-specific features (similar to JSON)
+* link:../xml/[XML Format] - XML-specific features

data/docs/understanding/formats/xml.adoc

@@ -439,8 +439,8 @@ canon diff expected.xml actual.xml \
 
 == See also
 
-* link:../comparison-pipeline.adoc[Comparison Pipeline] - Understanding the 4 layers
+* link:../../comparison-pipeline/[Comparison Pipeline] - Understanding the 4 layers
 * link:../../features/match-options/[Match Options] - All matching options
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Decision guide
-* link:index.adoc[Format Support] - Overview of all formats
-* link:html.adoc[HTML Format] - HTML-specific features
+* link:../../../guides/choosing-configuration/[Choosing Configuration] - Decision guide
+* link:../[Format Support] - Overview of all formats
+* link:../html/[HTML Format] - HTML-specific features

data/docs/understanding/formats/yaml.adoc

@@ -496,9 +496,9 @@ YAML is sensitive to indentation. Use `structural_whitespace: :ignore` to handle
 
 == See also
 
-* link:../comparison-pipeline.adoc[Comparison Pipeline] - Understanding the 4 layers
+* link:../../comparison-pipeline/[Comparison Pipeline] - Understanding the 4 layers
 * link:../../features/match-options/[Match Options] - All matching options
-* link:../../guides/choosing-configuration.adoc[Choosing Configuration] - Decision guide
-* link:index.adoc[Format Support] - Overview of all formats
-* link:json.adoc[JSON Format] - JSON-specific features (similar to YAML)
-* link:xml.adoc[XML Format] - XML-specific features
+* link:../../../guides/choosing-configuration/[Choosing Configuration] - Decision guide
+* link:../[Format Support] - Overview of all formats
+* link:../json/[JSON Format] - JSON-specific features (similar to YAML)
+* link:../xml/[XML Format] - XML-specific features

data/lib/canon/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Canon
-  VERSION = "0.3.28"
+  VERSION = "0.3.29"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: canon
 version: !ruby/object:Gem::Version
-  version: 0.3.28
+  version: 0.3.29
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-08 00:00:00.000000000 Z
+date: 2026-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs