igecloudsdev · pull · May 2, 2025 · May 8, 2025 · May 8, 2025 · May 14, 2025
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -13,7 +13,7 @@ jobs:
     steps:
     - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2.7.0
     - name: Set up Ruby
-      uses: ruby/setup-ruby@eaecf785f6a34567a6d97f686bbb7bccc1ac1e5c # v1.237.0
+      uses: ruby/setup-ruby@a4effe49ee8ee5b8b5091268c473a4628afb5651 # v1.245.0
       with:
         bundler-cache: true # runs 'bundle install' and caches installed gems automatically
     - name: Run tests

diff --git a/.github/workflows/schedule-doc-report.yml b/.github/workflows/schedule-doc-report.yml
@@ -11,7 +11,7 @@ jobs:
     steps:
     - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2.7.0
     - name: Set up Ruby
-      uses: ruby/setup-ruby@eaecf785f6a34567a6d97f686bbb7bccc1ac1e5c # v1.237.0
+      uses: ruby/setup-ruby@a4effe49ee8ee5b8b5091268c473a4628afb5651 # v1.245.0
       with:
         bundler-cache: true # runs 'bundle install' and caches installed gems automatically
     - name: Generate report

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -11,7 +11,7 @@ jobs:
     steps:
     - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
     - name: Set up Ruby
-      uses: ruby/setup-ruby@eaecf785f6a34567a6d97f686bbb7bccc1ac1e5c # v1.237.0
+      uses: ruby/setup-ruby@a4effe49ee8ee5b8b5091268c473a4628afb5651 # v1.245.0
       with:
         bundler-cache: true # runs 'bundle install' and caches installed gems automatically
     - name: Run tests

diff --git a/.ruby-version b/.ruby-version
@@ -1 +1 @@
-3.4.3
+3.4.4
diff --git a/.tool-versions b/.tool-versions
@@ -1 +1 @@
-ruby 3.4.3
+ruby 3.4.4
diff --git a/Dockerfile b/Dockerfile
@@ -1,4 +1,4 @@
-FROM ruby:3.4.3
+FROM ruby:3.4.4
 ENV LANG=C.UTF-8
 ENV ENABLE_SERVICE_WORKER=true
 

diff --git a/Dockerfile-alpine b/Dockerfile-alpine
@@ -1,4 +1,4 @@
-FROM ruby:3.4.3-alpine
+FROM ruby:3.4.4-alpine
 
 ENV LANG=C.UTF-8
 ENV ENABLE_SERVICE_WORKER=true

diff --git a/Gemfile b/Gemfile
@@ -1,5 +1,5 @@
 source 'https://rubygems.org'
-ruby '3.4.3'
+ruby '3.4.4'
 
 gem 'activesupport', require: false
 gem 'html-pipeline'

diff --git a/Gemfile.lock b/Gemfile.lock
@@ -78,14 +78,14 @@ GEM
       byebug (~> 12.0)
       pry (>= 0.13, < 0.16)
     racc (1.8.1)
-    rack (2.2.14)
+    rack (2.2.17)
     rack-protection (3.2.0)
       base64 (>= 0.1.0)
       rack (~> 2.2, >= 2.2.4)
     rack-ssl-enforcer (0.2.9)
     rack-test (2.2.0)
       rack (>= 1.3)
-    rake (13.2.1)
+    rake (13.3.0)
     rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
@@ -130,7 +130,7 @@ GEM
     strings-ansi (0.2.0)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
-    terser (1.2.5)
+    terser (1.2.6)
       execjs (>= 0.3.0, < 3)
     thin (1.8.2)
       daemons (~> 1.0, >= 1.0.9)
@@ -191,7 +191,7 @@ DEPENDENCIES
   yajl-ruby
 
 RUBY VERSION
-   ruby 3.4.3p32
+   ruby 3.4.4p34
 
 BUNDLED WITH
    2.4.6
diff --git a/README.md b/README.md
@@ -188,7 +188,7 @@ Made something cool? Feel free to open a PR to add a new row to this table! You
 | [girishji/devdocs.vim](https://github.com/girishji/devdocs.vim)                               | Vim plugin & TUI (browse inside Vim)                           | ![Latest GitHub commit](https://img.shields.io/github/last-commit/girishji/devdocs.vim?logo=github&label)             | ![GitHub stars](https://img.shields.io/github/stars/girishji/devdocs.vim?logo=github&label)             |
 | [romainl/vim-devdocs](https://github.com/romainl/vim-devdocs)                               | Vim plugin                           | ![Latest GitHub commit](https://img.shields.io/github/last-commit/romainl/vim-devdocs?logo=github&label)             | ![GitHub stars](https://img.shields.io/github/stars/romainl/vim-devdocs?logo=github&label)             |
 | [waiting-for-dev/vim-www](https://github.com/waiting-for-dev/vim-www)                       | Vim plugin                           | ![Latest GitHub commit](https://img.shields.io/github/last-commit/waiting-for-dev/vim-www?logo=github&label)         | ![GitHub stars](https://img.shields.io/github/stars/waiting-for-dev/vim-www?logo=github&label)         |
-| [luckasRanarison/nvim-devdocs](https://github.com/luckasRanarison/nvim-devdocs)             | Neovim plugin                        | ![Latest GitHub commit](https://img.shields.io/github/last-commit/luckasRanarison/nvim-devdocs?logo=github&label)    | ![GitHub stars](https://img.shields.io/github/stars/luckasRanarison/nvim-devdocs?logo=github&label)    |
+| [emmanueltouzery/apidocs.nvim](https://github.com/emmanueltouzery/apidocs.nvim)             | Neovim plugin                        | ![Latest GitHub commit](https://img.shields.io/github/last-commit/emmanueltouzery/apidocs.nvim?logo=github&label)    | ![GitHub stars](https://img.shields.io/github/stars/emmanueltouzery/apidocs.nvim?logo=github&label)    |
 | [toiletbril/dedoc](https://github.com/toiletbril/dedoc)                                     | Terminal based viewer                | ![Latest GitHub commit](https://img.shields.io/github/last-commit/toiletbril/dedoc?logo=github&label)                | ![GitHub stars](https://img.shields.io/github/stars/toiletbril/dedoc?logo=github&label)                |
 | [Raycast Devdocs](https://www.raycast.com/djpowers/devdocs)                                 | Raycast extension                    | Unavailable                 | Unavailable                |
 | [chrisgrieser/alfred-docs-searches](https://github.com/chrisgrieser/alfred-docs-searches)   | Alfred workflow                      | ![Latest GitHub commit](https://img.shields.io/github/last-commit/chrisgrieser/alfred-docs-searches?logo=github&label) | ![GitHub stars](https://img.shields.io/github/stars/chrisgrieser/alfred-docs-searches?logo=github&label) |

diff --git a/assets/javascripts/news.json b/assets/javascripts/news.json
@@ -1,4 +1,16 @@
 [
+  [
+    "2025-06-27",
+    "New documentation: <a href=\"/zsh/\">Zsh</a>"
+  ],
+  [
+    "2025-06-04",
+    "New documentation: <a href=\"/es_toolkit/\">es-toolkit</a>"
+  ],
+  [
+    "2025-05-28",
+    "New documentation: <a href=\"/vertx/\">Vert.x</a>"
+  ],
   [
     "2025-02-23",
     "New documentation: <a href=\"/threejs/\">Three.js</a>"

diff --git a/assets/stylesheets/global/_classes.scss b/assets/stylesheets/global/_classes.scss
@@ -133,6 +133,11 @@
   border-color: var(--noteRedBorder);
 }
 
+%note-gray, %label-gray {
+  background: var(--boxBackground);
+  border: 1px solid var(--boxBorder);
+}
+
 //
 // External links
 //

diff --git a/assets/stylesheets/pages/_mdn.scss b/assets/stylesheets/pages/_mdn.scss
@@ -28,12 +28,18 @@
 
   p > code, li > code { @extend %label; }
 
-  details { @extend %box; }
+  details { @extend %note; @extend %box; }
+  details.baseline-indicator.not { @extend %note; @extend %note-gray; }
+  details.baseline-indicator.low { @extend %note; @extend %note-blue; }
+  details.baseline-indicator.high { @extend %note; @extend %note-green; }
   summary > div { display: inline; }
+  summary .status-title { font-weight: bold; }
 
   > .note,
   .notecard, // MDN 2021
-  .notice,
+  .notice {
+    @extend %note; @extend %note-blue;
+  }
   .warning,
   .overheadIndicator,
   .blockIndicator,

diff --git a/docs/file-scrapers.md b/docs/file-scrapers.md
@@ -59,6 +59,12 @@ curl -L https://github.com/erlang/otp/releases/download/OTP-$RELEASE/otp_doc_htm
 bsdtar --extract --file - --directory=docs/erlang\~$VERSION/
 ```
 
+## es-toolkit
+
+```sh
+git clone https://github.com/toss/es-toolkit docs/es_toolkit
+```
+
 ## Gnu
 
 ### Bash

diff --git a/lib/app.rb b/lib/app.rb
@@ -376,6 +376,8 @@ def modern_browser?(browser)
     'angular~1.3' => 'angularjs~1.3',
     'angular~1.2' => 'angularjs~1.2',
     'codeigniter~3.0' => 'codeigniter~3',
+    'pytorch~1' => 'pytorch~1.13',
+    'pytorch~2' => 'pytorch',
     'webpack~2' => 'webpack'
   }
 

diff --git a/lib/docs/filters/express/clean_html.rb b/lib/docs/filters/express/clean_html.rb
@@ -7,14 +7,14 @@ def call
         i += 1 while n && n = n.previous_element
         at_css('h1')['data-level'] = i
 
-        @doc = at_css('#api-doc, .content')
+        @doc = at_css('#api-doc, main, .content')
+
+        css('nav').remove # aria-labelledby="sidebar-heading"
 
         css('section', 'div.highlighter-rouge').each do |node|
           node.before(node.children).remove
         end
 
-        @doc = at_css('#page-doc') unless root_page?
-
         if root_page?
           at_css('h1').remove
           css('> header', '#menu').remove

diff --git a/lib/docs/filters/github/clean_html.rb b/lib/docs/filters/github/clean_html.rb
@@ -2,6 +2,11 @@ module Docs
   class Github
     class CleanHtmlFilter < Filter
       def call
+        # Remove h1 wrapper to render it correctly.
+        css('.markdown-heading h1').each do |node|
+          node.parent.replace(node)
+        end
+
         css('.anchor').each do |node|
           node.parent['id'] = node['href'].remove('#')
           node.remove

diff --git a/lib/docs/filters/html/entries.rb b/lib/docs/filters/html/entries.rb
@@ -5,21 +5,22 @@ class EntriesFilter < Docs::EntriesFilter
 
       def get_name
         name = super
-        name.sub!('Element.', '').try(:downcase!)
-        name.sub!('Global attributes.', '').try(:concat, ' (attribute)')
+        name.sub!('Guides.', '')
+        name.sub!('How to.', '')
+        name.sub!('Reference.Elements.', '').try(:downcase!)
+        name.sub!('Reference.Attributes.', '').try(:concat, ' (attribute)')
+        name.sub!('Reference.Global attributes.', '').try(:concat, ' (attribute)')
         name.sub!(/input\.([-\w]+)/, 'input type="\1"')
         name
       end
 
       def get_type
-        return 'Miscellaneous' if slug.include?('CORS') || slug.include?('Using')
-
         if at_css('.deprecated', '.non-standard', '.obsolete')
-        'Obsolete'
-        elsif slug.start_with?('Global_attr')
-          'Attributes'
-        elsif slug.start_with?('Element/')
-          'Elements'
+          'Obsolete'
+        elsif slug.start_with?('Guides/')
+          'Guides'
+        elsif slug.start_with?('Reference/')
+          slug.split('/').drop(1).first.sub(/_/, ' ')
         else
           'Miscellaneous'
         end

diff --git a/lib/docs/filters/nginx_lua_module/entries.rb b/lib/docs/filters/nginx_lua_module/entries.rb
@@ -4,11 +4,11 @@ class EntriesFilter < Docs::EntriesFilter
       def additional_entries
         entries = []
 
-        css('#directives + ul > li > a').each do |node|
+        css('h2:contains("Directives") + ul > li > a').each do |node|
           entries << [node.content, node['href'].remove('#'), 'Directives']
         end
 
-        css('#nginx-api-for-lua + ul > li > a').each do |node|
+        css('h2:contains("Nginx API for Lua") + ul > li > a').each do |node|
           next if node.content == 'Introduction'
           entries << [node.content, node['href'].remove('#'), 'Nginx API for Lua']
         end

diff --git a/lib/docs/filters/pytorch/entries.rb b/lib/docs/filters/pytorch/entries.rb
@@ -1,92 +1,18 @@
 module Docs
   class Pytorch
     class EntriesFilter < Docs::EntriesFilter
-      TYPE_REPLACEMENTS = {
-        "torch.Tensor" => "Tensor",
-        "torch.nn" => "Neuro Network",
-        "Probability distributions - torch.distributions" => "Probability Distributions",
-        "torch" => "Torch",
-        "Quantization" => "Quantization",
-        "torch.optim" => "Optimization",
-        "torch.Storage" => "Storage",
-        "torch.nn.functional" => "NN Functions",
-        "torch.cuda" => "CUDA",
-        "Torch Distributed Elastic" => "Distributed Elastic",
-        "torch.fx" => "FX",
-        "TorchScript" => "Torch Script",
-        "torch.onnx" => "ONNX",
-        "Distributed communication package - torch.distributed" => "Distributed Communication",
-        "Automatic differentiation package - torch.autograd" => "Automatic Differentiation",
-        "torch.linalg" => "Linear Algebra",
-        "Distributed Checkpoint - torch.distributed.checkpoint" => "Distributed Checkpoint",
-        "Distributed RPC Framework" => "Distributed RPC",
-        "torch.special" => "SciPy-like Special",
-        "torch.package" => "Package",
-        "torch.backends" => "Backends",
-        "FullyShardedDataParallel" => "Fully Sharded Data Parallel",
-        "torch.sparse" => "Sparse Tensors",
-        "torch.export" => "Traced Graph Export",
-        "torch.fft" => "Discrete Fourier Transforms",
-        "torch.utils.data" => "Datasets and Data Loaders",
-        "torch.monitor" => "Monitor",
-        "Automatic Mixed Precision package - torch.amp" => "Automatic Mixed Precision",
-        "torch.utils.tensorboard" => "Tensorboard",
-        "torch.profiler" => "Profiler",
-        "torch.mps" => "MPS",
-        "DDP Communication Hooks" => "DDP Communication Hooks",
-        "Benchmark Utils - torch.utils.benchmark" => "Benchmark Utils",
-        "torch.nn.init" => "Parameter Initializations",
-        "Tensor Parallelism - torch.distributed.tensor.parallel" => "Tensor Parallelism",
-        "torch.func" => "JAX-like Function Transforms",
-        "Distributed Optimizers" => "Distributed Optimizers",
-        "torch.signal" => "SciPy-like Signal",
-        "torch.futures" => "Miscellaneous",
-        "torch.utils.cpp_extension" => "Miscellaneous",
-        "torch.overrides" => "Miscellaneous",
-        "Generic Join Context Manager" => "Miscellaneous",
-        "torch.hub" => "Miscellaneous",
-        "torch.cpu" => "Miscellaneous",
-        "torch.random" => "Miscellaneous",
-        "torch.compiler" => "Miscellaneous",
-        "Pipeline Parallelism" => "Miscellaneous",
-        "Named Tensors" => "Miscellaneous",
-        "Multiprocessing package - torch.multiprocessing" => "Miscellaneous",
-        "torch.utils" => "Miscellaneous",
-        "torch.library" => "Miscellaneous",
-        "Tensor Attributes" => "Miscellaneous",
-        "torch.testing" => "Miscellaneous",
-        "torch.nested" => "Miscellaneous",
-        "Understanding CUDA Memory Usage" => "Miscellaneous",
-        "torch.utils.dlpack" => "Miscellaneous",
-        "torch.utils.checkpoint" => "Miscellaneous",
-        "torch.__config__" => "Miscellaneous",
-        "Type Info" => "Miscellaneous",
-        "torch.utils.model_zoo" => "Miscellaneous",
-        "torch.utils.mobile_optimizer" => "Miscellaneous",
-        "torch._logging" => "Miscellaneous",
-        "torch.masked" => "Miscellaneous",
-        "torch.utils.bottleneck" => "Miscellaneous"
-      }
-
       def get_breadcrumbs
         css('.pytorch-breadcrumbs > li').map {
           |node| node.content.delete_suffix(' >').strip
         }.reject { |item| item.nil? || item.empty? }
       end
 
       def get_name
-        b = get_breadcrumbs
-        b[(b[1] == 'torch' ? 2 : 1)..].join('.')
+        get_breadcrumbs[-1]
       end
 
       def get_type
-        t = get_breadcrumbs[1]
-        TYPE_REPLACEMENTS.fetch(t, t)
-      end
-
-      def include_default_entry?
-        # Only include API entries to simplify and unify the list
-        return name.start_with?('torch.')
+        get_breadcrumbs[1]
       end
 
       def additional_entries
@@ -108,8 +34,6 @@ def additional_entries
             entries << [id + '()', id]
           when 'py class', 'py attribute', 'py property'
             entries << [id, id]
-          when 'footnote brackets', 'field-list simple'
-            next
           end
         end
 

diff --git a/lib/docs/filters/qunit/entries.rb b/lib/docs/filters/qunit/entries.rb
@@ -8,7 +8,8 @@ class EntriesFilter < Docs::EntriesFilter
         'assert' => '2. Assertions',
         'callbacks' => '3. Callback events',
         'config' => '4. Configuration',
-        'extension' => '5. Extension interface'
+        'extension' => '5. Extension interface',
+        'reporters' => '6. Reporters',
       }
       def get_name
         at_css('h1').content

diff --git a/lib/docs/filters/ramda/entries.rb b/lib/docs/filters/ramda/entries.rb
@@ -3,7 +3,9 @@ class Ramda
     class EntriesFilter < Docs::EntriesFilter
       def additional_entries
         css('ul.toc li').map do |node|
-          ["R.#{node['data-name']}", node['data-name'], node['data-category'].sub('Relaction', 'Relation')]
+          # As of 2025-06-20, `data-category` attribute is missing on https://ramdajs.com/ for Ramda versions < 0.29.0.
+          # This results in missing type for entries – and docs cannot be generated.
+          ["R.#{node['data-name']}", node['data-name'], node['data-category']]
         end
       end
     end

diff --git a/lib/docs/filters/rust/entries.rb b/lib/docs/filters/rust/entries.rb
@@ -4,8 +4,10 @@ class EntriesFilter < Docs::EntriesFilter
 
       def get_name
         if slug.start_with?('book') || slug.start_with?('reference')
-          name = at_css("#sidebar a[href='#{File.basename(slug)}']")
-          name ? name.content : 'Introduction'
+          name = at_css("h2", "h1")
+          ch1 = slug[/ch(\d+)-(\d+)/, 1]
+          ch2 = slug[/ch(\d+)-(\d+)/, 2]
+          name ? "#{ch1}.#{ch2}. #{name.content}" : 'Introduction'
         elsif slug == 'error-index'
           'Compiler Errors'
         else

diff --git a/lib/docs/filters/sanctuary_def/entries.rb b/lib/docs/filters/sanctuary_def/entries.rb
@@ -39,8 +39,10 @@ def additional_entries
           when "h3"
             type = node.text
           when "h4"
+            # Parent <div>'s ID set in github/clean_html.
+            id = node.parent.attributes["id"].value
             name = node.text.split(' :: ')[0]
-            id = node.attributes["id"].value
+
             entries << [name, id, type]
           end
         end