Enhance documentation (#424)

* Regenerate gemfile

Signed-off-by: Carlosespicur <carlosespicur@proton.me>

* Improve local building instructions

Signed-off-by: Carlosespicur <carlosespicur@proton.me>

* Fix status badges

Signed-off-by: Carlosespicur <carlosespicur@proton.me>

* Bump Ruby/bundler versions in CI

Signed-off-by: Carlosespicur <carlosespicur@proton.me>

* Fix html proofer version

Signed-off-by: Carlosespicur <carlosespicur@proton.me>

* Fix broken links

Signed-off-by: Carlosespicur <carlosespicur@proton.me>

* Use demobox_demo master branch

Signed-off-by: Carlosespicur <carlosespicur@proton.me>

---------

Signed-off-by: Carlosespicur <carlosespicur@proton.me>

Author: Carlosespicur

.github/workflows/ci.yml

@@ -15,15 +15,15 @@ jobs:
       with:
         submodules: true
 
-    - name: Set up Ruby 2.7
+    - name: Set up Ruby 3.4.5
       uses: ruby/setup-ruby@v1
       with:
-        ruby-version: 2.7.0
+        ruby-version: 3.4.5
 
     - name: Install Bundler
-      run: gem install bundler -v 2.4.22
+      run: gem install bundler -v 2.7.2
 
-    - uses: actions/cache@v1
+    - uses: actions/cache@v4
       with:
         path: vendor/bundle
         key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}

Gemfile

@@ -2,6 +2,6 @@ source 'https://rubygems.org'
 gem 'github-pages', group: :jekyll_plugins
 
 # Testing utilities
-gem "html-proofer"
+gem "html-proofer", "3.19.4"
 
 #gemspec