Try an FAQ page

CHANGELOG.md

@@ -18,6 +18,7 @@
 - Add `after-content.html` and `before-related.html` includes to ease docs site overrides.
 - GitHub Workflows security hardening [#3884](https://github.com/mmistakes/minimal-mistakes/issues/3884)
 - Replace Font Awesome v5 search page with v6.
+- Try adding an FAQ page.
 
 ## [4.25.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.25.0)
 

docs/_data/navigation.yml

@@ -78,6 +78,8 @@ docs:
         url: /docs/javascript/
   - title: Meta
     children:
+      - title: "FAQ"
+        url: /docs/faq/
       - title: "History"
         url: /docs/history/
       - title: "Contributing"

docs/_docs/05-configuration.md

@@ -1040,9 +1040,16 @@ The paginator only works on files with name `index.html`. To use pagination in a
 paginate_path: /recent/page:num/
 ```
 
-**Please note:** When using Jekyll's default [pagination plugin](https://jekyllrb.com/docs/pagination/) `paginator.posts` can only be called once. If you're looking for something more powerful that can paginate category, tag, and collection pages I suggest [**jekyll-paginate-v2**](https://github.com/sverrirs/jekyll-paginate-v2).
+**Please note:** When using Jekyll's default [pagination plugin](https://jekyllrb.com/docs/pagination/) `paginator.posts` can only be called once. If you're looking for something more powerful that can paginate category, tag, and collection pages, [**jekyll-paginate-v2**](https://github.com/sverrirs/jekyll-paginate-v2) is the way to go.
 {: .notice--info}
 
+#### Using Jekyll Paginate V2
+
+Jekyll Paginate V2 is not available on GitHub Pages. You must build your site locally or with a CI service like [GitHub Actions][gh-pages-actions].
+{: .notice--info}
+
+  [gh-pages-actions]: https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow
+
 ### Timezone
 
 This sets the timezone environment variable, which Ruby uses to handle time and date creation and manipulation. Any entry from the [IANA Time Zone Database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) is valid. The default is the local time zone, as set by your operating system.

docs/_docs/18-history.md

@@ -5,7 +5,7 @@ permalink: "/docs/history/"
 excerpt: Change log of enhancements and bug fixes made to the theme.
 sidebar:
   nav: docs
-last_modified_at: '2024-04-24T00:51:32+08:00'
+last_modified_at: '2024-04-26T00:43:39+08:00'
 toc: false
 ---
 
@@ -33,6 +33,7 @@ toc: false
 - Add `after-content.html` and `before-related.html` includes to ease docs site overrides.
 - GitHub Workflows security hardening [#3884](https://github.com/mmistakes/minimal-mistakes/issues/3884)
 - Replace Font Awesome v5 search page with v6.
+- Try adding an FAQ page.
 
 ## [4.25.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.25.0)
 

docs/_docs/22-faq.md

@@ -0,0 +1,18 @@
+---
+title: Frequently Asked Questions
+classes: wide
+permalink: "/docs/faq/"
+sidebar:
+  nav: docs
+last_modified_at: '2024-04-24T00:51:32+08:00'
+toc: false
+---
+
+This page is still under construction. Meanwhile, check out existing [issues](https://github.com/mmistakes/minimal-mistakes/issues) and [discussions](https://github.com/mmistakes/minimal-mistakes/discussions) to see if your question has already been asked before.
+{: .notice--primary }
+
+- `'require': cannot load such file -- webrick (LoadError)`
+
+  This error occurs when you run `jekyll serve` on Ruby 3.0+. 
+
+  Ruby 3.0 no longer comes with Webrick by default. To fix this, add `gem "webrick"` to your `Gemfile` and run `bundle install`. See [jekyll/jekyll#8523](https://github.com/jekyll/jekyll/issues/8523)