Skip to content

Per-app docs title format fix (drop "OpenRegister | OpenRegister" duplication) #80

@rubenvdlinde

Description

@rubenvdlinde

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

  • Every per-app docs site homepage has a unique <title> tag with no brand duplication
  • The new title still includes the brand for click-recognition
  • Description-pair-with-title still reads naturally

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions