Skip to content

Commit 0d95a63

Browse files
committed
Document remaining help SEO work
1 parent 3f5569b commit 0d95a63

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -125,3 +125,26 @@ that were missing their `/en/` prefix.
125125
never be built into HTML if it isn't referenced from `SUMMARY.md` — this
126126
caused an orphaned page (`engaging_with_discussions`) whose old redirect
127127
target silently never existed.
128+
129+
## SEO follow-ups after merging into Loomio
130+
131+
The GitHub Pages deployment now excludes redirect stubs and non-canonical
132+
aliases from the sitemap, generates page descriptions, and runs
133+
`check-seo.sh` before deployment. After the documentation is merged into the
134+
main Loomio repository, complete these remaining tasks when practical:
135+
136+
1. Replace mdBook's HTTP 200 meta-refresh redirect stubs with real permanent
137+
HTTP `301` or `308` redirects when a custom help server or proxy is
138+
available. Preserve every mapping in `[output.html.redirect]`, and keep
139+
the redirects indefinitely if possible so old bookmarks and search signals
140+
continue to reach the canonical pages.
141+
2. Search the main Loomio repository, including translated locale files, for
142+
links to legacy help paths. Update controlled links to point directly to
143+
the canonical URLs instead of passing through redirect stubs.
144+
3. Submit the corrected `https://help.loomio.com/sitemap.xml` in Google Search
145+
Console. Inspect representative old and new URL pairs, request indexing for
146+
important feature pages, and monitor Page Indexing for redirect or
147+
Google-selected-canonical problems.
148+
4. Preserve established public documentation URLs. Prefer changing page
149+
headings and navigation labels without moving source paths; when a move is
150+
necessary, add and test a permanent redirect before deploying it.

0 commit comments

Comments
 (0)