docs: add docs on using Lychee and fix lychee's build

.all-contributorsrc

@@ -1040,7 +1040,9 @@
       "avatar_url": "https://avatars.githubusercontent.com/u/7649194?v=4",
       "profile": "http://www.leahwasser.com",
       "contributions": [
-        "security"
+        "security",
+        "review",
+        "doc"
       ]
     },
     {
@@ -1049,7 +1051,8 @@
       "avatar_url": "https://avatars.githubusercontent.com/u/153130183?v=4",
       "profile": "https://mysiteintro.netlify.app/",
       "contributions": [
-        "translation"
+        "translation",
+        "doc"
       ]
     },
     {
@@ -1060,6 +1063,54 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "JimMadge",
+      "name": "Jim Madge",
+      "avatar_url": "https://avatars.githubusercontent.com/u/23616154?v=4",
+      "profile": "https://blog.jmadge.com",
+      "contributions": [
+        "review",
+        "infra",
+        "doc"
+      ]
+    },
+    {
+      "login": "JHWelch",
+      "name": "Jordan Welch",
+      "avatar_url": "https://avatars.githubusercontent.com/u/4480375?v=4",
+      "profile": "http://jordanwelch.com/",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "RichLewis007",
+      "name": "Rich Lewis",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1149213?v=4",
+      "profile": "https://github.com/RichLewis007",
+      "contributions": [
+        "bug",
+        "doc"
+      ]
+    },
+    {
+      "login": "parthamk",
+      "name": "Partha Mallick",
+      "avatar_url": "https://avatars.githubusercontent.com/u/110169184?v=4",
+      "profile": "http://parthamallick.com",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "rebeccaringuette",
+      "name": "Rebecca Ringuette",
+      "avatar_url": "https://avatars.githubusercontent.com/u/49281118?v=4",
+      "profile": "https://github.com/rebeccaringuette",
+      "contributions": [
+        "ideas"
+      ]
     }
   ],
   "repoType": "github",

.circleci/config.yml

@@ -62,24 +62,24 @@ workflows:
           filters:
             branches:
               only:
-                - master
+                - main
       - publish_release:
           requires:
             - node_modules
           filters:
             branches:
               only:
-                - master
+                - main
       - check_404s:
           requires:
             - publish_release
           filters:
             branches:
               only:
-                - master
+                - main
 
 experimental:
   notify:
     branches:
       only:
-        - master
+        - main

.github/PULL_REQUEST_TEMPLATE.md

@@ -4,7 +4,7 @@ Thanks for your interest in the project. Bugs filed and PRs submitted are apprec
 Please make sure that you are familiar with and follow the [Code of Conduct](https://allcontributors.org/docs/en/project/code-of-conduct) for this project.
 
 Also, please make sure you're familiar with and follow the instructions in the
-[contributing guidelines](https://github.com/all-contributors/all-contributors/blob/master/CONTRIBUTING.md) (found in the CONTRIBUTING.md file).
+[contributing guidelines](https://github.com/all-contributors/all-contributors/blob/main/CONTRIBUTING.md) (found in the CONTRIBUTING.md file).
 
 If you're new to contributing to open source projects, you might find this free
 video course helpful: http://kcd.im/pull-request

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    commit-message:
+      prefix: "chore(ci)"

.github/workflows/build-website.yml

@@ -3,31 +3,31 @@ name: Deploy to GitHub Pages
 on:
   push:
     branches:
-      - master
+      - docs-upgrade
 jobs:
   build:
-    name: Build Docusaurus
+    name: Build Astro site
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: /actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
         with:
           fetch-depth: 0
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@dbe1369d7be17e7823f8c1ee1ae8bec5779239dd # v3.9.0
         with:
-          node-version: 22
+          node-version: 23
           cache: npm
 
       - name: Install dependencies
         run: npm ci
       - name: Build website
         run: |
           npm run build
-          ls website/build
+          ls dist/
 
       - name: Upload Build Artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4.0.0
         with:
-          path: website/build/all-contributors
+          path: dist/
   deploy:
     name: Deploy to GitHub Pages
     needs: build
@@ -41,4 +41,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@f33f41b675f0ab2dc5a6863c9a170fe83af3571e # v4.0.0

.github/workflows/lint.yml

@@ -3,7 +3,7 @@ name: Lint
 on:
   push:
     branches:
-      - master
+      - main
   pull_request:
     types:
       - opened
@@ -13,6 +13,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-      - run: npx --package markdownlint-cli markdownlint **/*.md --ignore node_modules
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+      - run: npm ci
+      - run: npm run lint

.github/workflows/offline-link-check.yml

@@ -0,0 +1,21 @@
+name: Offline link check
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  link_check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - run: npm ci
+      - run: npm run build
+      - uses: lycheeverse/lychee-action@v2
+        with:
+          # Only check local files, no network requests
+          args: --config './lychee.toml' --no-progress --offline --root-dir "$GITHUB_WORKSPACE/dist/" dist/**/*.html
+          # Fail job when lychee returns a non-zero exit code
+          fail: true

.gitignore

@@ -25,8 +25,16 @@ node_modules
 logs
 *.log
 npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
 
-# Website
-website/build
-website/i18n
-website/translated_docs
+# Astro build output
+dist
+
+# Astro generated types
+.astro/
+
+# environment variables
+.env
+.env.production

.nvmrc

@@ -1 +1 @@
-16.17.0
+23.3.0

CONTRIBUTING.md

@@ -2,10 +2,9 @@
 
 We welcome contributions of all kinds to AllContributors.
 
-## 13 August 2025 Update:
+## 1 September 2025 Update:
 
-Currently, we are doing some work to revive the project. The documentation 
-website is not online but we are working to get it online soon. 
+Currently, we are doing some work to revive the project. The documentation online but some of the content (specifically the translations) are not working as expected.
 
 ************* THE LINKS BELOW DON'T CURRENTLY WORK ******
 

README.md

@@ -1,33 +1,26 @@
-> Call for translators! [We're looking for translators](https://github.com/all-contributors/all-contributors/issues/143) to help translate this spec for everyone!
+# Welcome to the All Contributors website repository
 
-<div align="center">
-    <a href="https://allcontributors.org">
-        <img src="docs/assets/logo-full.svg" alt="✨ All Contributors ✨" width="800px" />
-    </a>
-</div>
+[![✨ All Contributors ✨](src/assets/logo-full.svg)](https://allcontributors.org)
 
-<table>
-    <caption>Read this documentation in the following languages</caption>
-    <tbody>
-        <tr>
-            <td><a href="https://allcontributors.org/docs/ko/overview">한국어</a></td>
-            <td><a href="https://allcontributors.org/docs/zh-CN/overview">中文</a></td>
-            <td><a href="https://allcontributors.org/docs/id/overview">Bahasa Indonesia</a></td>
-            <td><a href="https://allcontributors.org/docs/de/overview">Deutsch</a></td>
-            <td><a href="https://allcontributors.org/docs/pl/overview">Polski</a></td>
-        </tr>
-        <tr>
-            <td><a href="https://allcontributors.org/docs/en/overview">English</a></td>
-            <td><a href="https://allcontributors.org/docs/pt-BR/overview">Português do Brasil</a></td>
-            <td><a href="https://allcontributors.org/docs/es-ES/overview">Español</a></td>
-            <td><a href="https://allcontributors.org/docs/fr/overview">Français</a></td>
-            <td><a href="https://allcontributors.org/docs/ru/overview">Русский</a></td>
-            <td><a href="https://allcontributors.org/docs/ja/overview">日本語</a></td>
-        </tr>
-    </tbody>
-</table>
+> Call for translators! [We're looking for translators](https://github.com/all-contributors/all-contributors/issues/143) to help translate this spec for everyone!
 
-[![Build Status](https://img.shields.io/circleci/project/all-contributors/all-contributors/master.svg)](https://circleci.com/gh/all-contributors/workflows/all-contributors/tree/master)
+**Read our documentation in the following languages:**
+
+| Language                | Link                                                                 |
+|-------------------------|---------------------------------------------------------------------|
+| 한국어                  | [한국어](https://allcontributors.org/docs/ko/overview)              |
+| 中文                    | [中文](https://allcontributors.org/docs/zh-CN/overview)             |
+| Bahasa Indonesia        | [Bahasa Indonesia](https://allcontributors.org/docs/id/overview)    |
+| Deutsch                 | [Deutsch](https://allcontributors.org/docs/de/overview)             |
+| Polski                  | [Polski](https://allcontributors.org/docs/pl/overview)              |
+| English                 | [English](https://allcontributors.org/docs/en/overview)             |
+| Português do Brasil     | [Português do Brasil](https://allcontributors.org/docs/pt-BR/overview) |
+| Español                 | [Español](https://allcontributors.org/docs/es-ES/overview)          |
+| Français                | [Français](https://allcontributors.org/docs/fr/overview)            |
+| Русский                 | [Русский](https://allcontributors.org/docs/ru/overview)             |
+| 日本語                  | [日本語](https://allcontributors.org/docs/ja/overview)              |
+
+[![Build Status](https://img.shields.io/circleci/project/all-contributors/all-contributors/main.svg)](https://circleci.com/gh/all-contributors/workflows/all-contributors/tree/main)
 [![Crowdin](https://d322cqt584bo4o.cloudfront.net/all-contributors/localized.svg)](https://crowdin.com/project/all-contributors)
 [![All Contributors](https://img.shields.io/github/all-contributors/all-contributors/all-contributors?color=ee8449&style=flat-square)](#contributors-)
 [![Netlify Status](https://api.netlify.com/api/v1/badges/e30784c5-9efd-4f20-8a47-13f3fb899613/deploy-status)](https://app.netlify.com/sites/allcontributors-org/deploys)
@@ -43,10 +36,9 @@ People are giving themselves and their free time to contribute to open source pr
 
 ## The All Contributors Table
 
-Below is an example of how using the all-contributors spec table can recognize all contributors
-<div align="center">
-    <img src="docs/assets/contributors-table-small.png" alt="All Contributors Table Screenshot" width="800px" />
-</div>
+Below is an example of how using the all-contributors spec table can recognize all contributors.
+
+![All Contributors Table Screenshot](src/assets/contributors-table-small.png)
 
 > You can use [the @all-contributors bot 🤖](https://allcontributors.org/docs/en/bot/overview) to automate acknowledging contributors to your open source projects
 
@@ -214,11 +206,16 @@ Thanks go to these wonderful people ([emoji key](https://allcontributors.org/doc
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/VitorCodes"><img src="https://avatars.githubusercontent.com/u/15626985?v=4?s=100" width="100px;" alt="Vitor Silva"/><br /><sub><b>Vitor Silva</b></sub></a><br /><a href="#translation-VitorCodes" title="Translation">🌍</a></td>
       <td align="center" valign="top" width="14.28%"><a href="http://flpm.dev"><img src="https://avatars.githubusercontent.com/u/17676929?v=4?s=100" width="100px;" alt="Felipe Moreno"/><br /><sub><b>Felipe Moreno</b></sub></a><br /><a href="#translation-flpm" title="Translation">🌍</a> <a href="https://github.com/all-contributors/all-contributors/commits?author=flpm" title="Code">💻</a> <a href="https://github.com/all-contributors/all-contributors/commits?author=flpm" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://piyushpamnani.github.io/Piyush-Portfolio/"><img src="https://avatars.githubusercontent.com/u/87657297?v=4?s=100" width="100px;" alt="Piyush Pamnani"/><br /><sub><b>Piyush Pamnani</b></sub></a><br /><a href="https://github.com/all-contributors/all-contributors/commits?author=PiyushPamnani" title="Documentation">📖</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="http://www.leahwasser.com"><img src="https://avatars.githubusercontent.com/u/7649194?v=4?s=100" width="100px;" alt="Leah Wasser"/><br /><sub><b>Leah Wasser</b></sub></a><br /><a href="#security-lwasser" title="Security">🛡️</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://mysiteintro.netlify.app/"><img src="https://avatars.githubusercontent.com/u/153130183?v=4?s=100" width="100px;" alt="Khushi"/><br /><sub><b>Khushi</b></sub></a><br /><a href="#translation-KhushiPandey8" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://www.leahwasser.com"><img src="https://avatars.githubusercontent.com/u/7649194?v=4?s=100" width="100px;" alt="Leah Wasser"/><br /><sub><b>Leah Wasser</b></sub></a><br /><a href="#security-lwasser" title="Security">🛡️</a> <a href="https://github.com/all-contributors/all-contributors/pulls?q=is%3Apr+reviewed-by%3Alwasser" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/all-contributors/all-contributors/commits?author=lwasser" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://mysiteintro.netlify.app/"><img src="https://avatars.githubusercontent.com/u/153130183?v=4?s=100" width="100px;" alt="Khushi"/><br /><sub><b>Khushi</b></sub></a><br /><a href="#translation-KhushiPandey8" title="Translation">🌍</a> <a href="https://github.com/all-contributors/all-contributors/commits?author=KhushiPandey8" title="Documentation">📖</a></td>
     </tr>
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="http://elmthomas.com"><img src="https://avatars.githubusercontent.com/u/58678?v=4?s=100" width="100px;" alt="Eric Thomas"/><br /><sub><b>Eric Thomas</b></sub></a><br /><a href="https://github.com/all-contributors/all-contributors/commits?author=et" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://blog.jmadge.com"><img src="https://avatars.githubusercontent.com/u/23616154?v=4?s=100" width="100px;" alt="Jim Madge"/><br /><sub><b>Jim Madge</b></sub></a><br /><a href="https://github.com/all-contributors/all-contributors/pulls?q=is%3Apr+reviewed-by%3AJimMadge" title="Reviewed Pull Requests">👀</a> <a href="#infra-JimMadge" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/all-contributors/all-contributors/commits?author=JimMadge" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://jordanwelch.com/"><img src="https://avatars.githubusercontent.com/u/4480375?v=4?s=100" width="100px;" alt="Jordan Welch"/><br /><sub><b>Jordan Welch</b></sub></a><br /><a href="https://github.com/all-contributors/all-contributors/commits?author=JHWelch" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/RichLewis007"><img src="https://avatars.githubusercontent.com/u/1149213?v=4?s=100" width="100px;" alt="Rich Lewis"/><br /><sub><b>Rich Lewis</b></sub></a><br /><a href="https://github.com/all-contributors/all-contributors/issues?q=author%3ARichLewis007" title="Bug reports">🐛</a> <a href="https://github.com/all-contributors/all-contributors/commits?author=RichLewis007" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://parthamallick.com"><img src="https://avatars.githubusercontent.com/u/110169184?v=4?s=100" width="100px;" alt="Partha Mallick"/><br /><sub><b>Partha Mallick</b></sub></a><br /><a href="https://github.com/all-contributors/all-contributors/commits?author=parthamk" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/rebeccaringuette"><img src="https://avatars.githubusercontent.com/u/49281118?v=4?s=100" width="100px;" alt="Rebecca Ringuette"/><br /><sub><b>Rebecca Ringuette</b></sub></a><br /><a href="#ideas-rebeccaringuette" title="Ideas, Planning, & Feedback">🤔</a></td>
     </tr>
   </tbody>
 </table>