markdowndocs 0.11.1 → 0.11.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb123f5ef96df8917be85966728453e124ae2f418acb7458a583c3d42254b068
-  data.tar.gz: e672f4cf03ee6a4fbb37a5cd2d924be8fb903256de7834adf36bfcf4e8877541
+  metadata.gz: ee414b6e508ae906b792f1abd65e21135a1439cf740998f69a1ad7cde743f1c1
+  data.tar.gz: 55f37cb07e8d2e274ca25fdc73e3448075fb945a7d10e852e596203893643190
 SHA512:
-  metadata.gz: 7a7f53ed3821883f3f858b50039a1ca03ba4bbfafdbf9302dedfb9a0c150ab1f25e198c3ca602e13cec493a469135bdc5b0fb28b9157182e1278409136928171
-  data.tar.gz: 15f9aa8cda587f9239ec84290d2fb1e3f3d6cf28c9b208b33d6081af842a5ce15eb5dcfa2a131905f41a228a03d19ea1dacd97fb3e80d35aa4a79f722cf4795a
+  metadata.gz: e0a49a7d046d2539060dd9bb4cab2f4d9d626c58020a41c898ee8627ae11eb99e2c28a9ff336291acbfd72b3903405e101abac33152fa99e3f0c2a6806d3be00
+  data.tar.gz: 8a7ef92900c9e99f9702838b7ab68cc619509c84cace45e1c0f86c94085154e546cc8dd4b94cfc89af9fcbaed6691db4722b556439405320f3fb33ceb00a9db1

data/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.3] - 2026-09-03
+
+### Accessibility
+
+- **The doc page emits one `main` landmark, not two.** `docs/show` wrapped its
+  content column in `<main>`, nesting a second landmark inside the one the host
+  layout (or this engine's own, standalone) already provides. axe reports it as
+  `landmark-no-duplicate-main` and `landmark-main-is-top-level`, and screen
+  readers get two competing "main" destinations on every `/docs/*` page. The
+  column is now a `<div>`; the `<article>` inside still carries the content
+  semantics.
+
+## [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)

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

data/app/views/markdowndocs/docs/show.html.erb

@@ -68,8 +68,10 @@
     <!-- Two-column layout -->
     <div class="grid grid-cols-1 gap-8
           lg:grid-cols-12">
-      <!-- Main content -->
-      <main class="lg:col-span-8">
+      <!-- Main content. A grid column, not a landmark: the page's `main` is the
+           host layout's (or this engine's own, when standalone), and a second
+           one nested inside it is a duplicate landmark. -->
+      <div class="lg:col-span-8">
         <article
           tabindex="-1"
           autofocus
@@ -78,7 +80,7 @@
             <%= raw @rendered_content %>
           </div>
         </article>
-      </main>
+      </div>
 
       <!-- Desktop sidebar (hidden on mobile, shown in grid on desktop) -->
       <div class="hidden lg:block lg:col-span-4">

data/lib/markdowndocs/version.rb

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

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: markdowndocs
 version: !ruby/object:Gem::Version
-  version: 0.11.1
+  version: 0.11.3
 platform: ruby
 authors:
 - Dave Chmura
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -114,6 +115,7 @@ metadata:
   homepage_uri: https://github.com/dschmura/markdowndocs
   source_code_uri: https://github.com/dschmura/markdowndocs
   changelog_uri: https://github.com/dschmura/markdowndocs/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -128,7 +130,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: A drop-in markdown documentation site for Rails apps
 test_files: []