markdowndocs 0.11.0 → 0.11.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4066fc2cf3c03c9f743aaaab41c62611b5206ef9d0dad6cdead66c02f39eba29
-  data.tar.gz: 9594a84833fca33b4ec4d4a6c81efd1cc21d28e57fddca30f1f4765073ced9bb
+  metadata.gz: 28f9775decd9995a54bf22809d3ef0a27cb5c684e4aa068a42592f7723c7ebd8
+  data.tar.gz: 5f1b6adc6bd424e4ef1c872432d11c6d93ea5c18fe1cc25dd389deea7c1c3a5e
 SHA512:
-  metadata.gz: 82e59acd421e1b32d0739167035ec770049ac0d27e1e5f00e7f3a9df5a01df00a7419be05443f9ae1ac45110eba1ad23fc0ccc73daf5c56388b2d1d867676d2e
-  data.tar.gz: 96b3a5cefdde9a74e349111f33b7f33106e1587d3e1cbeef911a2cdafb0588d3ba43b0dd7cdb591c88256a4d151ecc44e076a0c87d009121cf200b62ee1f21da
+  metadata.gz: aca1b149e1727df52bf8ab922291cf9148e0c70867098674e11e5d4d092c278c800bf96017267c43763e1e3b009f998a87ecd4ee7800514d5087770ee33c65b2
+  data.tar.gz: 3f06f7c533c897094139c6d7ea90484314a1a3531fd64c56a9e615896599057ebb2c6165a138d17ba0f85089c10f0e68e259cd6c004e7466035f4bbd225e24ab

data/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.11.2] - 2026-07-15
+
+### Accessibility
+
+- **Scrollable code blocks are keyboard-focusable.** Long lines make a `<pre>`
+  overflow horizontally via the host's CSS; a scrollable region that isn't
+  focusable strands keyboard-only users (WCAG 2.1.1; axe
+  `scrollable-region-focusable`). Every rendered code block now carries
+  `tabindex="0"`, mirroring the same fix already applied to wide tables in
+  0.11.0. No `aria-label` is added — a `<pre>`'s own text is its accessible
+  name.
+
+## [0.11.1] - 2026-07-13
+
+### Accessibility (follow-up review)
+
+- **Caption-less tables get a numbered, localized accessible name.** v0.11.0
+  labelled every un-captioned table the hardcoded English `"Table"`, so a
+  page of tables was undifferentiated to a screen reader and unlocalized.
+  They are now `"Table 1"`, `"Table 2"`, … via the new
+  `markdowndocs.table_label` I18n key (`"Table %{number}"`).
+
 ## [0.11.0] - 2026-07-13
 
 ### Accessibility

data/app/services/markdowndocs/markdown_renderer.rb

@@ -85,10 +85,26 @@ module Markdowndocs
         end
 
         mark_tables_keyboard_accessible(doc)
+        mark_code_blocks_keyboard_accessible(doc)
 
         doc.to_html
       end
 
+      # A code block (<pre>) overflows horizontally on long lines and becomes
+      # scrollable via the host's CSS, which the engine does not control and
+      # cannot inspect at render time — the same keyboard-access gap as wide
+      # tables (WCAG 2.1.1; axe `scrollable-region-focusable`). `tabindex="0"`
+      # makes each <pre> focusable so a keyboard-only user can scroll it with
+      # the arrow keys. Unlike a <table> we add NO aria-label: a <pre>'s own
+      # text content is its accessible name, so the focus stop is announced
+      # with the code itself; a synthetic "Code block N" label would only add
+      # noise. Same trade-off as tables — every code block becomes a tab stop,
+      # not only the ones that actually overflow, because scroll state is
+      # unknowable without a browser and this is a static (JS-free) fix.
+      def mark_code_blocks_keyboard_accessible(doc)
+        doc.css("pre").each { |pre| pre["tabindex"] = "0" }
+      end
+
       # A wide GFM table overflows its column and becomes horizontally
       # scrollable — via the host's typography/prose CSS, which the engine
       # does not control and cannot inspect at render time. A scrollable
@@ -109,9 +125,16 @@ module Markdowndocs
       # a static (JS-free) engine fix is worth that small amount of extra tab
       # travel.
       def mark_tables_keyboard_accessible(doc)
-        doc.css("table").each do |table|
+        doc.css("table").each_with_index do |table, index|
           table["tabindex"] = "0"
-          table["aria-label"] = "Table" unless table.at_css("caption") || table["aria-label"]
+          next if table.at_css("caption") || table["aria-label"]
+
+          # A caption-less table still needs an accessible name for its focus
+          # stop — but a page of identically-named "Table" regions is
+          # undifferentiated to a screen reader tabbing through. Number them,
+          # and route the label through I18n so non-English docs localize it.
+          table["aria-label"] = I18n.t("markdowndocs.table_label", number: index + 1,
+            default: "Table %{number}")
         end
       end
 

data/config/locales/en.yml

@@ -1,6 +1,7 @@
 en:
   markdowndocs:
     back_to_documentation: "Back to Documentation"
+    table_label: "Table %{number}"
     navigation_sidebar: "Navigation & Related Docs"
     viewing_mode: "Viewing Mode"
     select_viewing_mode: "Select documentation viewing mode"

data/lib/markdowndocs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Markdowndocs
-  VERSION = "0.11.0"
+  VERSION = "0.11.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: markdowndocs
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.11.2
 platform: ruby
 authors:
 - Dave Chmura