facterdb 1.27.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a919f9f2e0540c6214d032572ea4612bbb5a24a0a0ae7e500c86c8df61555d1
-  data.tar.gz: 2330ed37caf3b4c000bddc30082a7c029605c1c8fbfa19dc3b012bf91a67b03b
+  metadata.gz: faf53b6a468fc99aede788c2ede930af2176bdef6054e5bac446916ed8be5ca6
+  data.tar.gz: 00b5c7adbb10c83eeeeb9ba085cc1230a3edbf67dff6b1e7582ac2cc2f928ded
 SHA512:
-  metadata.gz: d1c795ac177c9e72adebda26bda7f2c4e585d3082bd17f5cc29f090a2d7328a287a5c926e65aaa3b1477687e744a892ad3751ced4f8979d6d0a12e37ebb975cf
-  data.tar.gz: 05ae0ec296eebda03067716a2c0ce94d96efcee4a506389eae657e164ffad3c9c4a599714fcc0e91efe3de9b4ed9fa02eab9a31b6f7d61355783a4c7d17d5164
+  metadata.gz: 8111bd85279714edf6ea83a2e0ad2b8570577baece7c460ad0851eddee90593b06ae20868389c1fa1335c27de30cf934e217071fb82d51c0f03883e360be9bbe
+  data.tar.gz: f2fbe4e878c723bcb00f6e9cc56f1a20ab3762f2f56095a693451a427fcf0ce39841e256f54c885d37807470a6fc3072b10b1a586d1c65c81d6144ab2c9c4cd6

data/.github/workflows/pages.yml

@@ -0,0 +1,41 @@
+name: Deploy docs to Pages
+
+on:
+  push:
+    branches: ['master']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+      - name: Build docs
+        run: bundle exec rake yard
+      - name: Set up Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: build_docs
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

data/.github/workflows/release.yml

@@ -15,8 +15,11 @@ jobs:
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: '3.3'
+          bundler-cache: true
         env:
           BUNDLE_WITHOUT: release
+      - name: Generate database
+        run: bundle exec rake database
       - name: Build gem
         run: gem build --strict --verbose *.gemspec
       - name: Publish gem to rubygems.org

data/.gitignore

@@ -5,6 +5,9 @@ coverage/
 .envrc
 vendor/
 .vendor/
+.yardoc
 packer_cache/
 *.box
+build_docs/
+database/
 hugo/public

data/.rubocop.yml

@@ -3,3 +3,6 @@ inherit_from: .rubocop_todo.yml
 
 inherit_gem:
   voxpupuli-rubocop: rubocop.yml
+
+Style/IfUnlessModifier:
+  Enabled: false

data/.rubocop_todo.yml

@@ -129,7 +129,6 @@ Style/FrozenStringLiteralComment:
     - 'lib/facterdb.rb'
     - 'lib/facterdb/bin.rb'
     - 'lib/facterdb/version.rb'
-    - 'rakelib/rhel_alts.rake'
     - 'spec/facter_db_spec.rb'
     - 'spec/facts_spec.rb'
     - 'spec/spec_helper.rb'

data/.yardopts

@@ -0,0 +1,7 @@
+--output-dir ./build_docs
+--template-path doc/templates/
+--template facterdb
+--title 'FacterDB Documentation'
+--files README.md,CHANGELOG.md,database/*
+--asset images/
+--main doc/main.md

data/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## [2.0.1](https://rubygems.org/gems/facterdb/versions/2.0.1) (2024-05-28)
+
+[Full Changelog](https://github.com/voxpupuli/facterdb/compare/2.0.0...2.0.1)
+
+The 2.0.0 wasn't released to rubygems due to a CI failure. 2.0.1 fixed the CI configuration and doesn't contain any other changes.
+
+**Fixed bugs:**
+
+- CI: Install gems in release workflow [\#356](https://github.com/voxpupuli/facterdb/pull/356) ([bastelfreak](https://github.com/bastelfreak))
+
+## [2.0.0](https://rubygems.org/gems/facterdb/versions/2.0.0) (2024-05-28)
+
+[Full Changelog](https://github.com/voxpupuli/facterdb/compare/1.27.0...2.0.0)
+
+**Breaking changes:**
+
+- deprecate legacy facts [\#350](https://github.com/voxpupuli/facterdb/pull/350) ([bastelfreak](https://github.com/bastelfreak))
+- Drop EoL OracleLinux 6 factset [\#345](https://github.com/voxpupuli/facterdb/pull/345) ([bastelfreak](https://github.com/bastelfreak))
+- Drop EoL Fedora 32-35 facts [\#333](https://github.com/voxpupuli/facterdb/pull/333) ([bastelfreak](https://github.com/bastelfreak))
+- Drop EoL Ubuntu 16.04 facts [\#332](https://github.com/voxpupuli/facterdb/pull/332) ([bastelfreak](https://github.com/bastelfreak))
+- Drop EoL Debian 9/10 factsets [\#331](https://github.com/voxpupuli/facterdb/pull/331) ([bastelfreak](https://github.com/bastelfreak))
+- get\_facts.sh: Drop support for Puppet 7 [\#330](https://github.com/voxpupuli/facterdb/pull/330) ([bastelfreak](https://github.com/bastelfreak))
+- Drop Facter 3 and older factsets [\#298](https://github.com/voxpupuli/facterdb/pull/298) ([bastelfreak](https://github.com/bastelfreak))
+
+**Implemented enhancements:**
+
+- Gentoo: Regenerate factsets & Add missing factsets [\#349](https://github.com/voxpupuli/facterdb/pull/349) ([bastelfreak](https://github.com/bastelfreak))
+- Arch Linux: Regenerate factsets & Add missing Facter 4.6/4.7 factsets [\#348](https://github.com/voxpupuli/facterdb/pull/348) ([bastelfreak](https://github.com/bastelfreak))
+- Fedora 38/39: regenerate facts & Add Missing Facter 4.6/4.7 factsets & Switch to upstream images [\#346](https://github.com/voxpupuli/facterdb/pull/346) ([bastelfreak](https://github.com/bastelfreak))
+- Ensure we use the latest facter versions for each minor release [\#341](https://github.com/voxpupuli/facterdb/pull/341) ([bastelfreak](https://github.com/bastelfreak))
+- Fedora 37: Regenerate factsets & Add Facter 4.6/4.7 factsets [\#338](https://github.com/voxpupuli/facterdb/pull/338) ([bastelfreak](https://github.com/bastelfreak))
+- Fedora 36: Regenerate factsets & Add missing factsets for Facter 4.5/4.6/4.7 [\#336](https://github.com/voxpupuli/facterdb/pull/336) ([bastelfreak](https://github.com/bastelfreak))
+
+**Fixed bugs:**
+
+- rubygems facter: Drop facter 4.0.52 & 4.1.1 [\#347](https://github.com/voxpupuli/facterdb/pull/347) ([bastelfreak](https://github.com/bastelfreak))
+- Fedora 36: Add IPv6 facts [\#343](https://github.com/voxpupuli/facterdb/pull/343) ([bastelfreak](https://github.com/bastelfreak))
+- Ensure every instance is started with IPv6 enabled [\#340](https://github.com/voxpupuli/facterdb/pull/340) ([bastelfreak](https://github.com/bastelfreak))
+- Ensure all facts have networking.ip6 fact [\#255](https://github.com/voxpupuli/facterdb/pull/255) ([bastelfreak](https://github.com/bastelfreak))
+
+**Merged pull requests:**
+
+- Customize YARD generation [\#352](https://github.com/voxpupuli/facterdb/pull/352) ([yakatz](https://github.com/yakatz))
+- Remove rhel\_alts script and update facts for OracleLinux 8 and 9 [\#344](https://github.com/voxpupuli/facterdb/pull/344) ([yakatz](https://github.com/yakatz))
+- Load puppet versions from shared file & Add missing factsets [\#334](https://github.com/voxpupuli/facterdb/pull/334) ([yakatz](https://github.com/yakatz))
+- List instead of table [\#327](https://github.com/voxpupuli/facterdb/pull/327) ([yakatz](https://github.com/yakatz))
+- Add test for augeas.version fact [\#319](https://github.com/voxpupuli/facterdb/pull/319) ([bastelfreak](https://github.com/bastelfreak))
+
 ## [1.27.0](https://rubygems.org/gems/facterdb/versions/1.27.0) (2024-05-15)
 
 [Full Changelog](https://github.com/voxpupuli/facterdb/compare/1.26.0...1.27.0)
@@ -43,6 +91,7 @@
 
 - CI: Build gem with --strict --verbose & add version contraints to dependencies [\#311](https://github.com/voxpupuli/facterdb/pull/311) ([bastelfreak](https://github.com/bastelfreak))
 - Add Ruby 3.3 to CI matrix [\#310](https://github.com/voxpupuli/facterdb/pull/310) ([bastelfreak](https://github.com/bastelfreak))
+- Update voxpupuli-rubocop requirement from ~\> 2.4.0 to ~\> 2.7.0 [\#308](https://github.com/voxpupuli/facterdb/pull/308) ([dependabot[bot]](https://github.com/apps/dependabot))
 
 ## [1.24.0](https://rubygems.org/gems/facterdb/versions/1.24.0) (2024-03-19)
 
@@ -52,6 +101,10 @@
 
 - Rebuild RHEL facts on Vagrant [\#304](https://github.com/voxpupuli/facterdb/pull/304) ([yakatz](https://github.com/yakatz))
 
+**Merged pull requests:**
+
+- Update voxpupuli-rubocop requirement from ~\> 2.3.0 to ~\> 2.4.0 [\#299](https://github.com/voxpupuli/facterdb/pull/299) ([dependabot[bot]](https://github.com/apps/dependabot))
+
 ## [1.23.0](https://rubygems.org/gems/facterdb/versions/1.23.0) (2024-01-09)
 
 [Full Changelog](https://github.com/voxpupuli/facterdb/compare/1.22.0...1.23.0)
@@ -66,10 +119,19 @@
 
 - Ensure the selinux topscope fact is present [\#296](https://github.com/voxpupuli/facterdb/pull/296) ([bastelfreak](https://github.com/bastelfreak))
 
+**Merged pull requests:**
+
+- Update voxpupuli-rubocop requirement from ~\> 2.1.0 to ~\> 2.3.0 [\#295](https://github.com/voxpupuli/facterdb/pull/295) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Update voxpupuli-rubocop requirement from ~\> 2.0.0 to ~\> 2.1.0 [\#291](https://github.com/voxpupuli/facterdb/pull/291) ([dependabot[bot]](https://github.com/apps/dependabot))
+
 ## [1.22.0](https://rubygems.org/gems/facterdb/versions/1.22.0) (2023-11-13)
 
 [Full Changelog](https://github.com/voxpupuli/facterdb/compare/1.21.0...1.22.0)
 
+**Breaking changes:**
+
+- Drop Ruby 2.5/2.6 [\#274](https://github.com/voxpupuli/facterdb/pull/274) ([bastelfreak](https://github.com/bastelfreak))
+
 **Implemented enhancements:**
 
 - fedora38 facts [\#287](https://github.com/voxpupuli/facterdb/pull/287) ([hbrown-uiowa](https://github.com/hbrown-uiowa))
@@ -82,6 +144,10 @@
 
 - Correct class documentation [\#281](https://github.com/voxpupuli/facterdb/pull/281) ([ekohl](https://github.com/ekohl))
 
+**Merged pull requests:**
+
+- Update voxpupuli-rubocop requirement from ~\> 1.3.0 to ~\> 2.0.0 [\#280](https://github.com/voxpupuli/facterdb/pull/280) ([dependabot[bot]](https://github.com/apps/dependabot))
+
 ## [1.21.0](https://rubygems.org/gems/facterdb/versions/1.21.0) (2023-01-25)
 
 [Full Changelog](https://github.com/voxpupuli/facterdb/compare/1.20.0...1.21.0)
@@ -324,7 +390,6 @@
 
 **Merged pull requests:**
 
-- release 1.6.0 [\#163](https://github.com/voxpupuli/facterdb/pull/163) ([bastelfreak](https://github.com/bastelfreak))
 - Archlinux: Update fact sets [\#162](https://github.com/voxpupuli/facterdb/pull/162) ([bastelfreak](https://github.com/bastelfreak))
 
 ## [1.5.0](https://rubygems.org/gems/facterdb/versions/1.5.0) (2020-11-19)

data/Gemfile

@@ -7,4 +7,6 @@ gem 'facter', ENV.fetch('FACTER_GEM_VERSION', nil), require: false
 group :development do
   gem 'faraday-retry', require: false
   gem 'github_changelog_generator', '>= 1.16.4', require: false
+  gem 'redcarpet'
+  gem 'yard'
 end

data/README.md

@@ -12,6 +12,12 @@ A Gem that contains a lot of facts for a lot of Operating Systems.
 
 ![FacterDB](images/facterdb.png)
 
+
+**With facterdb 2 legacy facts are deprecated and will be removed in facterdb 3**
+
+Some facts were declared legacy a long time ago: [Core facts documentation](https://www.puppet.com/docs/puppet/latest/core_facts.html)
+With Puppet 8 they are disabled by default. With the release of facterdb 3 we will also remove the legacy facts from our factsets.
+
 # Usage
 
 ## CLI
@@ -57,136 +63,10 @@ require 'facterdb'
 FacterDB::get_facts('osfamily=Debian')
 ```
 
-## Facter version and Operating System coverage
-
-|      operating system       | 1.6 | 1.7 | 2.0 | 2.1 | 2.2 | 2.3 | 2.4 | 2.5 | 3.0 | 3.1 | 3.2 | 3.3 | 3.4 | 3.5 | 3.6 | 3.7 | 3.8 | 3.9 | 3.10 | 3.11 | 3.12 | 3.13 | 3.14 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5 | 4.6 | 4.7 |
-| --------------------------- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| AIX 5300                    |     |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| AIX 6100                    |     |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| AIX 7100                    |     |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| AlmaLinux 8                 |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |
-| AlmaLinux 9                 |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |
-| Amazon                      |  3  |     |     |     |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Amazon 2                    |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |  1  |     |     |
-| Amazon 4                    |     |  3  |  3  |  3  |     |     |     |     |  1  |  1  |     |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Amazon 2016                 |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Amazon 2017                 |     |     |     |     |  1  |  1  |  1  |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Amazon 2022                 |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |     |     |     |     |     |
-| Archlinux                   |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |  1  |  1  |  1  |  1  |     |     |
-| CentOS 5                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |
-| CentOS 6                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| CentOS 7                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  2  |  2  |     |  2  |  1  |  1  |  2  |  1  |  1  |  1  |  1  |  2  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |
-| CentOS 8                    |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |
-| CentOS 9                    |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |  1  |  1  |  1  |  1  |  1  |
-| Darwin                      |     |     |  4  |  4  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Darwin 14                   |     |     |  2  |  2  |  2  |  2  |  2  |  1  |     |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Darwin 15                   |     |     |     |     |  1  |  1  |  1  |  1  |     |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |
-| Darwin 16                   |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Darwin 17                   |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Darwin 18                   |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |     |  1  |  1  |     |     |     |     |     |     |     |     |
-| Darwin 19                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |
-| Darwin 20                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |     |     |     |     |     |
-| Debian 6                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Debian 7                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Debian 8                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Debian 9                    |  1  |  1  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |  2  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |  1  |     |     |     |     |     |
-| Debian 10                   |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |
-| Debian 11                   |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |
-| Debian 12                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  2  |  2  |  2  |  1  |  1  |  1  |
-| Fedora 19                   |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Fedora 22                   |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Fedora 23                   |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Fedora 24                   |  1  |  1  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Fedora 25                   |     |     |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Fedora 26                   |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |
-| Fedora 27                   |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |  1  |     |     |     |     |  1  |     |     |     |     |     |     |     |     |     |     |     |
-| Fedora 28                   |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Fedora 29                   |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Fedora 30                   |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |     |     |     |     |     |     |     |     |
-| Fedora 32                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |
-| Fedora 33                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |
-| Fedora 34                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |
-| Fedora 35                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |     |     |     |     |     |
-| Fedora 36                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |  1  |  1  |     |     |     |
-| Fedora 37                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |
-| Fedora 38                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |
-| Fedora 39                   |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |
-| FreeBSD 9                   |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| FreeBSD 10                  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| FreeBSD 11                  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  2  |  1  |  1  |  1  |     |     |     |     |     |
-| FreeBSD 12                  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  2  |  1  |  1  |  1  |     |     |  1  |     |     |
-| FreeBSD 13                  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |
-| Gentoo                      |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |     |     |     |     |     |  1  |     |     |
-| LinuxMint 18                |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |  1  |     |  1  |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| LinuxMint 19                |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| OpenBSD 5.7                 |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| OpenBSD 5.8                 |     |     |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| OpenBSD 5.9                 |     |     |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| OpenBSD 6.0                 |     |     |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| OpenBSD 6.2                 |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| OpenBSD 6.3                 |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |  2  |     |     |     |     |     |     |     |     |     |     |     |     |
-| OpenBSD 6.4                 |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |     |     |
-| OpenBSD 7.5                 |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |
-| OpenSuSE 12                 |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| OpenSuSE 13                 |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| OpenSuSE 15                 |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| OpenSuSE 42                 |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| OracleLinux 5               |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |
-| OracleLinux 6               |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  2  |  1  |  1  |  1  |     |     |  1  |     |     |     |     |     |
-| OracleLinux 7               |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  2  |  2  |     |  2  |  1  |  1  |  2  |  1  |  1  |  1  |  1  |  2  |  1  |  1  |  1  |  1  |     |  1  |     |     |     |     |     |
-| OracleLinux 8               |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |  1  |     |     |     |     |     |
-| OracleLinux 9               |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |
-| Pop!_OS 21.10               |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |
-| Raspbian 9                  |     |     |     |     |     |     |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Raspbian 10                 |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  2  |     |     |     |     |     |     |     |     |     |     |     |
-| RedHat 5                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |
-| RedHat 6                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  3  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| RedHat 7                    |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  2  |  2  |     |  2  |  1  |  1  |  2  |  1  |  1  |  1  |  1  |  2  |  1  |  1  |  1  |  1  |     |  1  |     |     |     |     |     |
-| RedHat 8                    |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |
-| RedHat 9                    |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |  1  |  1  |  1  |  1  |  1  |
-| Rocky 8                     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |
-| Rocky 9                     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |
-| SLES 11                     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| SLES 12                     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |  1  |  1  |  1  |     |     |     |
-| SLES 15                     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |  1  |     |     |     |     |     |
-| Scientific 5                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |
-| Scientific 6                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Scientific 7                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  2  |  2  |     |  2  |  1  |  1  |  2  |  1  |  1  |  1  |  1  |  2  |  1  |  1  |  1  |  1  |     |  1  |     |     |     |     |     |
-| Solaris 10                  |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |     |  1  |     |  1  |     |     |     |     |     |     |     |     |     |     |     |
-| Solaris 11                  |  1  |  1  |  1  |  1  |  1  |  2  |  2  |  1  |     |     |     |     |     |     |     |     |     |     |     |  2  |     |     |  2  |  1  |     |     |     |     |     |     |     |
-| Ubuntu 10.04                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Ubuntu 12.04                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Ubuntu 14.04                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Ubuntu 14.10                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Ubuntu 15.04                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Ubuntu 15.10                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |     |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Ubuntu 16.04                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |
-| Ubuntu 16.10                |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  2  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Ubuntu 18.04                |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |
-| Ubuntu 20.04                |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |
-| Ubuntu 21.04                |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |
-| Ubuntu 21.10                |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |     |     |     |     |     |
-| Ubuntu 22.04                |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |  1  |  1  |  1  |  1  |  1  |
-| Ubuntu 22.10                |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |  1  |     |     |     |     |     |
-| VirtuozzoLinux 7            |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |     |     |     |     |     |     |     |     |
-| Windows 7                   |     |     |     |  1  |  1  |  1  |  2  |  1  |  2  |  2  |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Windows 8.1                 |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Windows 10                  |     |     |     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |  2  |     |     |  1  |  1  |  1  |     |  1  |  1  |
-| Windows Server 2008         |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Windows Server 2008 R2      |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
-| Windows Server 2012         |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |  1  |  1  |  1  |     |     |     |
-| Windows Server 2012 R2      |     |     |     |  1  |  1  |  1  |  2  |  1  |  1  |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |  1  |  1  |  1  |     |     |     |
-| Windows Server 2012 R2 Core |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |     |     |     |     |     |     |
-| Windows Server 2016         |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |  1  |  1  |  1  |     |     |     |
-| Windows Server 2016 Core    |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |     |     |     |
-| Windows Server 2019         |     |     |     |     |     |     |     |  1  |  1  |  1  |     |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |  1  |     |     |  1  |  1  |  1  |     |  1  |  1  |
-| Windows Server 2019 Core    |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |     |     |     |
-| Windows Server 2022         |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |     |  1  |  1  |
-| Windows Server 2022 Core    |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |     |     |     |
-| openSUSE 15                 |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |  1  |  1  |  1  |     |     |
-| windows 11                  |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |  1  |  1  |  1  |     |  1  |  1  |
-
-Where the number (1, 2 etc.) are the number of factsets for that OS and facter combination (e.g., x86_64 and i386 architectures).
+## Included Factsets
+
+Starting with version 1.28.0 (May 2024), check [RubyDoc](https://www.rubydoc.info/gems/facterdb/) for Factsets included in each released gem.
+Check the [Voxpupuli website](https://voxpupuli.org/facterdb/) for Factsets included in the `master` branch.
 
 ## Add new Operating System support
 

data/Rakefile

@@ -10,8 +10,7 @@ begin
   require 'github_changelog_generator/task'
   GitHubChangelogGenerator::RakeTask.new :changelog do |config|
     config.future_release = FacterDB::Version::STRING
-    config.include_labels = %w[enhancement bug]
-    config.exclude_labels = %w[duplicate question invalid wontfix maintenance github_actions]
+    config.exclude_labels = %w[duplicate question invalid wontfix wont-fix maintenance skip-changelog github_actions]
     config.user = 'voxpupuli'
     config.project = 'facterdb'
     config.release_url = 'https://rubygems.org/gems/facterdb/versions/%s'
@@ -24,6 +23,15 @@ rescue LoadError
   end
 end
 
+begin
+  require 'yard'
+rescue LoadError
+  # No yard
+else
+  YARD::Rake::YardocTask.new
+  task yard: :database # rubocop:disable Rake/Desc
+end
+
 # Generate a human-friendly OS label based on a given factset
 def factset_to_os_label(fs)
   os_rel  = '???'
@@ -78,8 +86,8 @@ def factset_to_os_label(fs)
     db_filename = fs[:_facterdb_filename] || 'there_is_no_filename'
     label = if /windows-10-/.match?(db_filename)
               'Windows 10'
-            elsif /windows-7-/.match?(db_filename)
-              'Windows 7'
+            elsif /windows-11-/.match?(db_filename)
+              'Windows 11'
             elsif /windows-8[\d.]*-/.match?(db_filename)
               "Windows #{os__rel.sub('6.2.9200', '8').sub('6.3.9600', '8.1')}"
             elsif /windows-.+-core-/.match?(db_filename)
@@ -99,9 +107,47 @@ def factset_to_os_label(fs)
   label
 end
 
-desc 'generate a markdown table of Facter/OS coverage (for the README)'
-task :table do
+def normalize_arch(arch_str)
+  case arch_str
+  when 'x86_64', 'amd64'
+    'x86_64'
+  when 'i386'
+    'i386'
+  else
+    arch_str
+  end
+end
+
+def factset_hash_to_markdown(h, caption1: nil, caption2: nil, caption3: nil)
+  content = ''
+
+  h.each do |label1, data1|
+    indent = ''
+    content += "#{indent} - "
+    content += "#{caption1} " if caption1
+    content += "#{label1}\n"
+    indent += '  '
+    data1.each do |label2, data2|
+      content += "#{indent}- "
+      content += "#{caption2} " if caption2
+      content += "#{label2}:"
+
+      data2.each do |label3|
+        content += " #{caption3}" if caption3
+        content += " #{label3}"
+      end
+      content += "\n"
+    end
+  end
+
+  content
+end
+
+desc 'generate a markdown table of Facter/OS coverage'
+task :database do
   require_relative 'lib/facterdb'
+  FileUtils.mkdir_p 'database'
+
   # Turn on the source injection
   old_env = ENV.fetch('FACTERDB_INJECT_SOURCE', nil)
   ENV['FACTERDB_INJECT_SOURCE'] = 'true'
@@ -112,15 +158,42 @@ task :table do
   facter_versions = factsets.map do |x|
     Gem::Version.new(x[:facterversion].split('.')[0..1].join('.'))
   end.uniq.sort.map(&:to_s)
+
+  # Old table
   os_facter_matrix = {}
 
+  # New lists
+  os_facter_arch_list = {}
+  os_arch_facter_list = {}
+  facter_os_arch_list = {}
+  # Can't think of any reason facter_arch_os_list would be useful
+  arch_os_facter_list = {}
+  # Can't think of any reason arch_facter_os_list would be useful
+
   # Process the facts and create a hash of all the OS and facter combinations
   factsets.each do |facts|
     fv = facts[:facterversion].split('.')[0..1].join('.')
+    arch = normalize_arch(facts[:hardwaremodel]) || 'Missing Value'
     label = factset_to_os_label(facts)
     os_facter_matrix[label] ||= {}
     os_facter_matrix[label][fv] ||= 0
     os_facter_matrix[label][fv] += 1
+
+    os_facter_arch_list[label] ||= {}
+    os_facter_arch_list[label][fv] ||= []
+    os_facter_arch_list[label][fv] << arch
+
+    os_arch_facter_list[label] ||= {}
+    os_arch_facter_list[label][arch] ||= []
+    os_arch_facter_list[label][arch] << fv
+
+    facter_os_arch_list[fv] ||= {}
+    facter_os_arch_list[fv][label] ||= []
+    facter_os_arch_list[fv][label] << arch
+
+    arch_os_facter_list[arch] ||= {}
+    arch_os_facter_list[arch][label] ||= []
+    arch_os_facter_list[arch][label] << fv
   end
   # Extract the OS list
   os_versions = os_facter_matrix.keys.uniq.sort_by do |label|
@@ -130,24 +203,51 @@ task :table do
     string_pieces.zip(number_pieces).flatten.compact
   end
 
-  readme_path = File.expand_path(File.join(__dir__, 'README.md'))
-  readme = File.read(readme_path).split("\n")
-  new_readme = readme[0..readme.index { |r| r.start_with?('| ') } - 1]
-
   # Write out a nice table
   os_version_width = (os_versions.map { |x| x.size } + [17]).max
-  new_readme << "| #{'operating system'.center(os_version_width)} |#{facter_versions.map { |x| " #{x} |" }.join}"
-  new_readme << "| #{'-' * os_version_width} |#{facter_versions.map { |_x| ' --- |' }.join}"
+  facter_width = 3
+
+  rows = [
+    ['operating system'.center(os_version_width)] + facter_versions,
+    ['-' * os_version_width] + (['-' * facter_width] * facter_versions.length),
+  ]
+
   os_versions.each do |label|
-    fvs = facter_versions.map { |facter_version| os_facter_matrix[label][facter_version] || 0 }
-    row = "| #{label.ljust(os_version_width)} |"
-    fvs.each { |fv| row += ((fv > 0) ? " #{fv.to_s.center(3)} |" : '     |') }
-    new_readme << row
+    fvs = facter_versions.map do |facter_version|
+      version = os_facter_matrix[label][facter_version] || 0
+      (version > 0) ? version.to_s : ''
+    end
+    rows << ([label.ljust(os_version_width)] + fvs.map { |fv| fv.center(facter_width) })
   end
 
-  File.open(readme_path, 'w') do |fd|
-    fd.puts (new_readme + readme[readme.rindex { |r| r.start_with?('| ') } + 1..-1]).join("\n")
+  content = "# @title Table of Available Factsets\n\n"
+  content += "# Facter version and Operating System coverage\n\n"
+  rows.each do |row|
+    content += "| #{row.join(' | ')} |\n"
   end
+  content += "\n\nWhere the number (1, 2 etc.) are the number of factsets for that OS and facter combination (e.g., x86_64 and i386 architectures).\n"
+
+  File.write(File.join(__dir__, 'database', 'table.md'), content)
+
+  content = "# @title Available Factsets Grouped By OS -> Facter -> Architecture\n\n"
+  content += "# Available Facts Grouped By OS -> Facter\n\n"
+  content += factset_hash_to_markdown(os_facter_arch_list, caption2: 'Facter')
+  File.write(File.join(__dir__, 'database', 'list_os_facter_arch.md'), content)
+
+  content = "# @title Available Factsets Grouped By OS -> Architecture -> Facter Version\n\n"
+  content += "# Available Facts Grouped By OS -> Arch\n\n"
+  content += factset_hash_to_markdown(os_arch_facter_list)
+  File.write(File.join(__dir__, 'database', 'list_os_arch_facter.md'), content)
+
+  content = "# @title Available Factsets Grouped By Facter Version -> OS -> Architecture\n\n"
+  content += "# Available Facts Grouped By Facter -> OS\n\n"
+  content += factset_hash_to_markdown(facter_os_arch_list, caption1: 'Facter')
+  File.write(File.join(__dir__, 'database', 'list_facter_os_arch.md'), content)
+
+  content = "# @title Available Factsets Grouped By Architecture -> OS -> Facter Version\n\n"
+  content += "# Available Facts Grouped By Arch -> OS\n\n"
+  content += factset_hash_to_markdown(arch_os_facter_list)
+  File.write(File.join(__dir__, 'database', 'list_arch_os_facter.md'), content)
 end
 
 begin