docs: redirect legacy GitHub Pages site to Mintlify (#4759)

* docs: redirect legacy Pages site to Mintlify (mybd-aokv)

Agent-Signature: codex-gpt-5.6-sol-high on behalf of matt wilkie

* docs: harden legacy Pages redirect

Agent-Signature: codex-gpt-5.6-terra-medium on behalf of matt wilkie
This commit is contained in:
matt wilkie 2026-07-13 14:19:13 -07:00 • committed by GitHub
commit ee7e494147
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
8 changed files with 102 additions and 7 deletions

44
.github/pages-redirect/index.html vendored Normal file
View file

@ -0,0 +1,44 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="robots" content="noindex" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="redirect-destination" content="https://beads.gascity.com" />
<meta http-equiv="refresh" content="1; url=https://beads.gascity.com/" />
<title>Beads documentation has moved</title>
</head>
<body>
<p>
The Beads documentation has moved to
<a id="destination" href="https://beads.gascity.com/">beads.gascity.com</a>.
</p>
<noscript>
<p>
JavaScript is required to preserve this page's path. Continue to the
<a href="https://beads.gascity.com/">current Beads documentation</a>.
</p>
</noscript>
<script>
(function () {
var path = window.location.pathname;
var destinationPath = path;
if (path === "/beads" || path === "/beads/") {
destinationPath = "/";
} else if (path.indexOf("/beads/") === 0) {
destinationPath = path.slice("/beads".length);
}
var destination =
document.querySelector('meta[name="redirect-destination"]').content +
destinationPath +
window.location.search +
window.location.hash;
document.getElementById("destination").href = destination;
window.location.replace(destination);
})();
</script>
</body>
</html>

View file

@ -0,0 +1,47 @@
name: Deploy legacy docs redirect
on:
push:
branches:
- main
paths:
- '.github/pages-redirect/**'
- '.github/workflows/deploy-pages-redirect.yml'
workflow_dispatch:
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: pages
cancel-in-progress: false
jobs:
deploy:
if: ${{ github.repository == 'gastownhall/beads' }}
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v6
with:
sparse-checkout: .github/pages-redirect
- name: Build redirect artifact
run: |
mkdir -p _site
cp -f .github/pages-redirect/index.html _site/index.html
cp -f .github/pages-redirect/index.html _site/404.html
- name: Upload redirect artifact
uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5
with:
path: _site
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5

View file

@ -10,7 +10,7 @@
[![npm version](https://img.shields.io/npm/v/@beads/bd)](https://www.npmjs.com/package/@beads/bd)
[![PyPI](https://img.shields.io/pypi/v/beads-mcp)](https://pypi.org/project/beads-mcp/)
**Docs:** https://gastownhall.github.io/beads/
**Docs:** https://beads.gascity.com/
Beads provides a persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.
@ -111,7 +111,7 @@ version: sync remote-backed databases with your current `bd`, back up with
migration on a remote-backed database, exactly one designated clone runs
`bd migrate --force` and `bd dolt push`; other clones install the new binary
and run `bd bootstrap`. See the full
[upgrade guide](https://gastownhall.github.io/beads/getting-started/upgrading)
[upgrade guide](https://beads.gascity.com/getting-started/upgrading)
or [docs/getting-started/installation.md](docs/getting-started/installation.md#updating-bd).
### Security And Verification
@ -184,5 +184,5 @@ For daemon mode without git, use `bd daemon start --local`
## 📝 Documentation
* [Documentation site](https://gastownhall.github.io/beads/) (versioned) | [Installing](docs/getting-started/installation.md) | [Sync Concepts](docs/core-concepts/sync-concepts.md) | [Agent Workflow](AGENT_INSTRUCTIONS.md) | [Copilot CLI Setup](docs/integrations/copilot-cli.md) | [Copilot VS Code MCP](docs/integrations/github-copilot.md) | [Articles](ARTICLES.md) | [Sync Branch Mode](docs/reference/protected-branches.md) | [Troubleshooting](docs/reference/troubleshooting.md) | [FAQ](docs/reference/faq.md)
* [Documentation site](https://beads.gascity.com/) | [Installing](docs/getting-started/installation.md) | [Sync Concepts](docs/core-concepts/sync-concepts.md) | [Agent Workflow](AGENT_INSTRUCTIONS.md) | [Copilot CLI Setup](docs/integrations/copilot-cli.md) | [Copilot VS Code MCP](docs/integrations/github-copilot.md) | [Articles](ARTICLES.md) | [Sync Branch Mode](docs/reference/protected-branches.md) | [Troubleshooting](docs/reference/troubleshooting.md) | [FAQ](docs/reference/faq.md)
* [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/gastownhall/beads)

View file

@ -210,6 +210,10 @@
{
"source": "/1.0.5/:slug*",
"destination": "/:slug*"
},
{
"source": "/1.1.0/:slug*",
"destination": "/:slug*"
}
],
"navigation": {

View file

@ -37,4 +37,4 @@ commands to match your project before first use.
## Creating Your Own
See the [Formulas documentation](https://gastownhall.github.io/beads/workflows/formulas) for the full reference.
See the [Formulas documentation](https://beads.gascity.com/workflows/formulas) for the full reference.

View file

@ -100,7 +100,7 @@ This package downloads the appropriate native binary for your platform:
For complete documentation, see the [beads GitHub repository](https://github.com/gastownhall/beads):
- [Complete README](https://github.com/gastownhall/beads#readme)
- [Quick Start (documentation site)](https://gastownhall.github.io/beads/getting-started/quickstart) · [in-repo source](https://github.com/gastownhall/beads/blob/main/docs/getting-started/quickstart.md)
- [Quick Start (documentation site)](https://beads.gascity.com/getting-started/quickstart) · [in-repo source](https://github.com/gastownhall/beads/blob/main/docs/getting-started/quickstart.md)
- [Installation Guide](https://github.com/gastownhall/beads/blob/main/docs/getting-started/installation.md)
- [FAQ](https://github.com/gastownhall/beads/blob/main/docs/reference/faq.md)
- [Troubleshooting](https://github.com/gastownhall/beads/blob/main/docs/reference/troubleshooting.md)

View file

@ -3,7 +3,7 @@ description: Quick start guide for bd workflows (deprecated)
argument-hint: []
---
**Note:** The `bd quickstart` command is deprecated. See the [Quick Start](https://gastownhall.github.io/beads/getting-started/quickstart) on the documentation site, or the in-repo source [docs/getting-started/quickstart.md](https://github.com/gastownhall/beads/blob/main/docs/getting-started/quickstart.md).
**Note:** The `bd quickstart` command is deprecated. See the [Quick Start](https://beads.gascity.com/getting-started/quickstart) on the documentation site, or the in-repo source [docs/getting-started/quickstart.md](https://github.com/gastownhall/beads/blob/main/docs/getting-started/quickstart.md).
The quickstart documentation covers:
- Getting started with bd

View file

@ -8,6 +8,6 @@ Use these live sources instead:
- `bd <command> --help` for command-specific usage
- `bd help --all` for the complete local CLI reference
- `docs/CLI_REFERENCE.md` in the beads repository for the generated Markdown reference
- <https://gastownhall.github.io/beads/cli-reference/> for the published generated reference
- <https://beads.gascity.com/cli-reference/> for the published generated reference
Maintainers: regenerate repository CLI docs with `./scripts/generate-cli-docs.sh`. Do not paste generated command output into this skill resource.