@@ -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