Part of #75 (SEO epic).
What
Fix the duplicate-brand titles on per-app docs site homepages. Currently Docusaurus auto-appends | {site title} to every page, so the homepage with frontmatter title: OpenRegister becomes OpenRegister | OpenRegister. Same pattern on every per-app docs site.
Why
SEO audit flagged this as a wasted SERP title slot. The duplicate burns brand inventory in the click-decision moment and confuses users. Fix is one-line per site.
Approach
In each per-app docs site's docs/src/pages/index.js (or index.mdx), change the page-level title from the bare app name to something descriptive:
| Site |
Before |
After |
| openregister |
OpenRegister |
OpenRegister, schema-driven object store for Nextcloud |
| opencatalogi |
OpenCatalogi |
OpenCatalogi, public software catalog for Nextcloud |
| ... |
... |
... |
After fix Docusaurus emits e.g. "OpenRegister, schema-driven object store for Nextcloud | OpenRegister". The leading clause carries the keyword payload; the suffix stays as brand anchor.
Alternative
Add a titleFormat option to @conduction/docusaurus-preset that suppresses the auto-suffix on the homepage when frontmatter.title ends with the site title. Preset minor bump.
Scope
17 fleet docs sites + conduction-website's homepage (already fixed in PR #57 with title "Public Tech for Nextcloud").
Acceptance
Part of #75 (SEO epic).
What
Fix the duplicate-brand titles on per-app docs site homepages. Currently Docusaurus auto-appends
| {site title}to every page, so the homepage with frontmattertitle: OpenRegisterbecomesOpenRegister | OpenRegister. Same pattern on every per-app docs site.Why
SEO audit flagged this as a wasted SERP title slot. The duplicate burns brand inventory in the click-decision moment and confuses users. Fix is one-line per site.
Approach
In each per-app docs site's
docs/src/pages/index.js(orindex.mdx), change the page-level title from the bare app name to something descriptive:OpenRegisterOpenRegister, schema-driven object store for NextcloudOpenCatalogiOpenCatalogi, public software catalog for NextcloudAfter fix Docusaurus emits e.g.
"OpenRegister, schema-driven object store for Nextcloud | OpenRegister". The leading clause carries the keyword payload; the suffix stays as brand anchor.Alternative
Add a
titleFormatoption to@conduction/docusaurus-presetthat suppresses the auto-suffix on the homepage whenfrontmatter.titleends with the site title. Preset minor bump.Scope
17 fleet docs sites + conduction-website's homepage (already fixed in PR #57 with title "Public Tech for Nextcloud").
Acceptance