Skip to content

feat: rename /workflow to /spec-driven-development for SEO#449

Merged
rdmueller merged 3 commits into
LLM-Coding:mainfrom
raifdmueller:feat/rename-workflow-sdd
Apr 30, 2026
Merged

feat: rename /workflow to /spec-driven-development for SEO#449
rdmueller merged 3 commits into
LLM-Coding:mainfrom
raifdmueller:feat/rename-workflow-sdd

Conversation

@raifdmueller

@raifdmueller raifdmueller commented Apr 30, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Rename route from /workflow to /spec-driven-development for better SEO discoverability
  • Page title: "Spec-Driven Development with Semantic Anchors"
  • Nav label: "Spec-Driven Dev" (EN + DE)
  • Old /workflow URL redirects automatically
  • All cross-links updated (brownfield pages, sitemap, prerender-routes)

Test plan

  • Navigate to /spec-driven-development — page loads with new title
  • Navigate to /workflow — redirects to /spec-driven-development
  • Check nav link text shows "Spec-Driven Dev"
  • Switch to DE — verify nav label and page content
  • Brownfield page links back to /spec-driven-development
  • View page source — verify <title> tag

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

  • Documentation

    • Dokumentationsbereich "Workflow" wurde in "Spec-Driven Development with Semantic Anchors" umbenannt.
    • Dokumentation ist jetzt unter aktualisiertem Titel zugänglich.
  • Chores

    • Navigation aktualisiert: Menüeinträge verweisen auf neue URL-Struktur.
    • Interne Links in Dokumentation angepasst.
    • Sitemaps und Routing neu konfiguriert.
    • Navigationsbezeichnungen in allen Sprachen aktualisiert.

- Route: /workflow → /spec-driven-development (with redirect from old URL)
- Page title: "Spec-Driven Development with Semantic Anchors"
- Nav label: "Spec-Driven Dev" (EN + DE)
- AsciiDoc h1 updated in both EN and DE versions
- All cross-links updated (brownfield pages, sitemap, prerender)
- Old /workflow URL redirects automatically via navigate()

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Apr 30, 2026

Copy link
Copy Markdown
Contributor

Warning

Rate limit exceeded

@raifdmueller has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 51 minutes and 52 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 5e37a0ac-7d40-48cb-b630-146bb53ed2cd

📥 Commits

Reviewing files that changed from the base of the PR and between 8f62f82 and 00e2230.

📒 Files selected for processing (4)
  • scripts/prerender-routes.js
  • website/src/main.js
  • website/src/utils/router.js
  • website/tests/e2e/website.spec.js

Walkthrough

Das Pull Request benennt die Workflow-Seite von der Route /workflow in /spec-driven-development um und aktualisiert alle zugehörigen Verweise in Dokumentation, Routing, Sitemap-Generierung, Navigation und Übersetzungen.

Changes

Cohort / File(s) Zusammenfassung
Dokumentation
docs/brownfield-workflow.adoc, docs/brownfield-workflow.de.adoc, docs/spec-driven-workflow.adoc, docs/spec-driven-workflow.de.adoc
Interne AsciiDoc-Anker-Links werden von #/workflow zu #/spec-driven-development aktualisiert; Dokumenttitel werden von "Semantic Anchors Development Workflow" zu "Spec-Driven Development with Semantic Anchors" umbenannt.
Routing und Navigation
website/src/main.js, website/src/utils/router.js, website/src/components/header.js
Route /workflow wird in /spec-driven-development umbenannt; ROUTE_TITLES-Map wird aktualisiert; Header-Navigation wird auf den neuen Route verwiesen; Redirect von /workflow zu /spec-driven-development hinzugefügt.
Sitemap und Prerender
scripts/generate-sitemap.js, scripts/prerender-routes.js
PAGES-Liste und Route-Konfiguration werden aktualisiert: /workflow wird durch /spec-driven-development ersetzt; SEO-Titel und Meta-Beschreibung werden angepasst.
Übersetzungen
website/src/translations/en.json, website/src/translations/de.json
Navigationsbeschriftung nav.workflow wird von "Workflow" zu "Spec-Driven Dev" geändert.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • PR #429: Ändert dieselbe Routing/Sitemap/Prerender-Konfiguration in scripts/generate-sitemap.js und scripts/prerender-routes.js für SPA-Route-Normalisierung.
  • PR #410: Aktualisiert ebenfalls docs/spec-driven-workflow.adoc (Workflow-Diagramm-Bildpfad).
  • PR #189: Ursprünglicher PR, der die "Workflow"/"Spec-Driven Development"-Seite mit Dokumentation, Routing, Header-Links und Übersetzungen hinzugefügt hat.
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 25.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Der Pull-Request-Titel beschreibt präzise die Hauptänderung: Umbenennung der Route von /workflow zu /spec-driven-development für SEO-Verbesserungen. Der Titel ist spezifisch, klar und bezieht sich direkt auf die im Changeset vorgenommenen Änderungen.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
Review rate limit: 0/1 reviews remaining, refill in 51 minutes and 52 seconds.

Comment @coderabbitai help to get the list of available commands and usage tips.

@rdmueller rdmueller left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@scripts/prerender-routes.js`:
- Around line 44-49: The new route replaced the old '/workflow' URL so a static
file for dist/workflow/index.html is no longer generated; add an explicit legacy
redirect entry in scripts/prerender-routes.js that preserves the old path by
creating a route object with path: '/workflow' (or a small redirect fragment)
which generates a static page at dist/workflow/index.html that redirects (via
meta-refresh and/or JS) to '/spec-driven-development' and reuses the same
fragment/title/description values (or points to docs/spec-driven-workflow.html)
so direct visits to /workflow on GitHub Pages are routed to the new URL.

In `@website/src/main.js`:
- Around line 149-150: The legacy redirect from the '/workflow' route uses
navigate('/spec-driven-development') which internally calls pushState and causes
a history back-loop; change the '/workflow' route handler registered via
addRoute to perform a replace navigation (use the navigate API or
history.replace variant that replaces the current entry) instead of pushing a
new history entry so that addRoute('/workflow', ...) replaces the current
history state with '/spec-driven-development' rather than pushing it.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: b24fb626-cc24-49f5-b57c-33d86782638f

📥 Commits

Reviewing files that changed from the base of the PR and between d80c9d7 and 8f62f82.

📒 Files selected for processing (11)
  • docs/brownfield-workflow.adoc
  • docs/brownfield-workflow.de.adoc
  • docs/spec-driven-workflow.adoc
  • docs/spec-driven-workflow.de.adoc
  • scripts/generate-sitemap.js
  • scripts/prerender-routes.js
  • website/src/components/header.js
  • website/src/main.js
  • website/src/translations/de.json
  • website/src/translations/en.json
  • website/src/utils/router.js

Comment thread scripts/prerender-routes.js
Comment thread website/src/main.js Outdated
raifdmueller and others added 2 commits April 30, 2026 12:03
Update trailing-slash URL test to use /spec-driven-development/
and expect the new page title.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…lback

- Use replaceState instead of pushState for /workflow → /spec-driven-development
  redirect to prevent back-button loop
- Add static redirect page at dist/workflow/index.html for direct URL access
  on GitHub Pages (meta http-equiv refresh + canonical link)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@rdmueller rdmueller merged commit e4ac35a into LLM-Coding:main Apr 30, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants