README: the production count follows the manifest; the rollback point is the outgoing release's version tag

manifest.json marks 8 maps production (the gallery's 7 plus the country map); Country Posters and Poster Design are in the gallery but still marked experimental, and the README now says so. Publishing tags the outgoing release with its own version (v0.2.0 in the example), which is the rollback point; going back means deploying the previous release's tag.
This commit is contained in:
Doxa Maps 2026-10-03 06:33:28 +00:00
parent 8a90eb5000
commit 6884c2a052

View file

@ -128,7 +128,7 @@ people groups of the world. When you work here, the goal is one of these:
every other plugin.
- **Land on `development`**, one change at a time through the lock, with `gates:pre`, `gates:post` and the landing checks passing. `main` is
production and moves only on a publish.
- These 10 maps are in production: the 9 in the gallery, plus the country map for DX Life's country pages. The
- These 8 maps are in production: the 7 production maps in the gallery, plus the country map for DX Life's country pages. The
other maps are experimental: leave them as they are unless your task is one
of them.
@ -138,10 +138,10 @@ people groups of the world. When you work here, the goal is one of these:
## The production maps
**Nine maps DX uses today, all together in the Research Gallery**, which DX Life publishes as
**Deep Research**; each one is also a plugin you can embed on its own. The seven below plus Country Posters
and Poster Design (see Posterverse). A tenth production map, the country map (`country-map`), draws DX Life's
country pages; it isn't in the gallery.
**Seven production maps DX uses today, all together in the Research Gallery**, which DX Life publishes
as **Deep Research**; each one is also a plugin you can embed on its own. The gallery also carries two
poster plugins still marked experimental, Country Posters and Poster Design (see Posterverse). An eighth
production map, the country map (`country-map`), draws DX Life's country pages; it isn't in the gallery.
<table>
<tr>
@ -327,7 +327,7 @@ improvement on the next build.
</details>
<details>
<summary><b>What the Research Gallery is made of — nine production maps, an Experimental shelf, all five capabilities in one plugin</b></summary>
<summary><b>What the Research Gallery is made of — seven production maps, two poster plugins, an Experimental shelf, all five capabilities in one plugin</b></summary>
```text
Research Gallery <doxa-maps-spa> capability 5
@ -807,18 +807,18 @@ these jobs to its agents.
```
Only a change to the build itself (its config or its dependencies) reaches every bundle:
`BUILD_ALLOW=1 bun run build`.
7. **Publish, when a person approves it:** tag the release the landing branch is on now as the
rollback point, fast-forward the landing branch to a pilot commit that passed the checks, tag it, and
deploy from the tag:
7. **Publish, when a person approves it:** make sure the release the landing branch is on now has its
own version tag (that tag is the rollback point), fast-forward the landing branch to a pilot commit
that passed the checks, tag it, and deploy from the tag:
```bash
git fetch origin && git switch main && git merge --ff-only origin/main
git tag -a rollback-v1.0.0 -m "Rollback point: the release before v1.0.0" && git push origin rollback-v1.0.0
git tag -a v0.2.0 -m "Release v0.2.0" && git push origin v0.2.0 # the outgoing release, if untagged
git merge --ff-only <development-commit> # a commit that passed the checks
bun run gates:pre && bun run gates:post # the checks must pass on exactly this commit
git tag -a v1.0.0 -m "Release v1.0.0" && git push origin main v1.0.0
```
The tag's `public/dx-maps/` folder is the built site: deploy that, and build the landing demo from
the same tag ([how to deploy](./documentation/DEPLOY.md)). To go back, deploy the rollback tag. Publish to a public host, such as GitHub, only from
the same tag ([how to deploy](./documentation/DEPLOY.md)). To go back, deploy the previous release's tag. Publish to a public host, such as GitHub, only from
the landing branch and only when it is ready.
### Developing in the cloud with a swarm