Add HTML validator action

.github/workflows/lighthouserc.json

@@ -0,0 +1,21 @@
+{
+  "ci": {
+    "collect": {
+      "staticDistDir": "./_site",
+      "autodiscoverUrlBlocklist": [
+        "conduct.html"
+      ],
+      "settings": {
+        "skipAudits": ["canonical"]
+      }
+    },
+    "assert": {
+      "assertions": {
+        "categories:performance": ["error", { "minScore": 0.95 }],
+        "categories:accessibility": ["error", { "minScore": 0.95 }],
+        "categories:best-practices": ["error", { "minScore": 0.95 }],
+        "categories:seo": ["error", { "minScore": 0.95 }]
+      }
+    }
+  }
+}

.github/workflows/validate.yml

@@ -0,0 +1,106 @@
+name: Test website
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    name: Build Jekyll site for testing
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Build the site in the Jekyll/builder container
+      run: |
+        docker run \
+        -v ${{ github.workspace }}:/srv/jekyll -v ${{ github.workspace }}/_site:/srv/jekyll/_site \
+        jekyll/builder:latest /bin/bash -c "chmod -R 777 /srv/jekyll && jekyll build --future"
+
+    - name: List result of Jekyll build
+      run: |
+        ls _site/ -l
+        ls _site/assets -l
+
+    # - name: Copy assets
+    # run: cp -r assets _site/assets
+
+    - name: Publish built site
+      uses: actions/upload-artifact@v2
+      with:
+        name: Built site ${{ github.run_number }}
+        path: ./_site
+        if-no-files-found: error
+
+  validate:
+
+    runs-on: ubuntu-latest
+    name: Validate HTML
+    needs: [build]
+
+    steps:
+    - name: Fetch built site
+      uses: actions/download-artifact@v2
+      with:
+        name: Built site ${{ github.run_number }}
+        path: ./_site
+
+    # just to satisfy the `Cyb3r-Jak3/html5validator-action` action
+    - name: Create dummy git repository
+      run: git init
+
+    - name: HTML5 Validator
+      uses: Cyb3r-Jak3/html5validator-action@44696509d19bec6bd00e5ebf29bbeda320562aac
+      with:
+        root: _site/
+
+  check-links:
+
+    runs-on: ubuntu-latest
+    name: Check links
+    needs: [build]
+
+    steps:
+    - name: Fetch built site
+      uses: actions/download-artifact@v2
+      with:
+        name: Built site ${{ github.run_number }}
+        path: ./_site
+
+    # TODO: we are not checking absolute links as pytest plugins does not support them
+    - name: Check links
+      run: |
+        pip install pytest-check-links
+        pytest _site/ --check-links \
+           --check-links-ignore "https://.*linkedin.com/.*" \
+           --check-links-ignore "/" \
+           --check-links-ignore= ".github/images/netlify-preview.png"
+
+  lighthouse:
+
+    runs-on: ubuntu-latest
+    name: Check quality with Lighthouse
+    needs: [build]
+
+    steps:
+      - name: Fetch repository for `lighthouserc.json`
+        uses: actions/checkout@v2
+      - name: Fetch built site
+        uses: actions/download-artifact@v2
+        with:
+          name: Built site ${{ github.run_number }}
+          path: ./_site
+      - name: Audit with Lighthouse
+        uses: treosh/lighthouse-ci-action@v8
+        with:
+          configPath: ".github/workflows/lighthouserc.json"
+          temporaryPublicStorage: true
+          uploadArtifacts: true

README.md

@@ -28,7 +28,7 @@ To build and preview the site locally, follow these steps:
 3. **Run the `build` command**
 
    ```console
-   $ nox -s build
+   $ nox -s build-live
    ```
 
 

binder.md

@@ -103,10 +103,10 @@ about the deployment. Here are a few useful resources in case you're interested:
   information about the BinderHub deployment at mybinder.org
 * [The mybinder.org billing repository](https://github.com/jupyterhub/binder-billing) has
   information about the cloud cost associated with running mybinder.org
-* [The mybinder.org site reliability guide](mybinder-sre.readthedocs.io/) is a resource
+* [The mybinder.org site reliability guide](https://mybinder-sre.readthedocs.io/en/latest/) is a resource
   for the operations team and the community to share best-practices and information about
   running the public BinderHub deployment at mybinder.org
-* [The mybinder.org incident reports page](mybinder-sre.readthedocs.io/en/latest/#incident-reports)
+* [The mybinder.org incident reports page](https://mybinder-sre.readthedocs.io/en/latest/#incident-reports)
   contains a list of incidents that have happened in the public deployment, as well as
   steps taken to resolve them.
 
@@ -123,7 +123,7 @@ to join our community and contribute code, time, comments, or appreciation.
   the current members of the JupyterHub and Binder teams.
 * [**The JupyterHub Contributing guide**](https://jupyterhub-team-compass.readthedocs.io/en/latest/contributing.html) is
   a great place to start learning how you can contribute to the Binder Project.
-* [**The Binder Gitter Channel**](https://gitter.im/binder) is where a lot of real-time
+* [**The Binder Gitter Channel**](https://gitter.im/jupyterhub/binder) is where a lot of real-time
   conversations happen in the Binder community.
 * [**The Binder Community Forum**](https://discourse.jupyter.org/c/binder) has a lot of
   community interaction and useful information about using, running, and contributing to Binder.

noxfile.py

@@ -12,7 +12,12 @@ def install_deps(session):
     session.run(*"bundle install".split())
 
 
+@nox.session(name="build-live", venv_backend='conda')
+def build_live(session):
+    install_deps(session)
+    session.run(*"bundle exec jekyll serve liveserve".split())
+
 @nox.session(venv_backend='conda')
 def build(session):
     install_deps(session)
-    session.run(*"bundle exec jekyll serve liveserve".split())
+    session.run(*"bundle exec jekyll build".split())

widgets.html

@@ -323,7 +323,7 @@ <h3>Installation</h3>
             </span>
           </div>
           <p>
-          <a href="https://BeakerX.com">BeakerX</a> includes widgets
+          <a href="http://beakerx.com">BeakerX</a> includes widgets
           for interactive tables, plots, forms, Apache Spark, and more.
           The table widget automatically recognizes pandas dataframes
           and allows you to search, sort, drag, filter, format,