fix(website): uglyURLs on main, update documentation - #4871
Draft
alex-dna-tech wants to merge 5 commits into
Draft
fix(website): uglyURLs on main, update documentation#4871alex-dna-tech wants to merge 5 commits into
alex-dna-tech wants to merge 5 commits into
Conversation
alex-dna-tech
marked this pull request as draft
July 31, 2026 06:12
alex-dna-tech
changed the title
Contributor
Author
Duplicate frontmatter titles in
|
| Duplicate Title | File 1 | File 2 |
|---|---|---|
| Agent Guardrails | blog/news/agent-guardrails.md |
docs/guides/agent-guardrails.md |
| AI Integration | docs/ai-integration.md |
docs/overview/ai-integration/index.md |
| Architecture | docs/architecture.md |
docs/overview/architecture/index.md |
| Architecture Decision Records | docs/architecture/index.md |
docs/project/architecture/_index.md |
| Broker | docs/broker.md |
docs/interfaces/broker/index.md |
| Configuration | docs/config.md |
docs/overview/config/index.md |
| Contributing | docs/contributing.md |
docs/guides/contributing.md, docs/project/contributing.md |
| Documentation | docs/_index.md |
docs/index.md |
| Examples | docs/examples/_index.md |
docs/examples/index.md |
| Getting Started | docs/getting-started.md |
docs/overview/getting-started/index.md |
| Hello Service | docs/examples/hello-service.md |
docs/examples/learn-by-examples/hello-service.md |
| Observability | docs/observability.md |
docs/overview/observability/index.md |
| Performance Considerations | docs/overview/performance.md |
docs/performance.md |
| Plugins | docs/interfaces/plugins.md |
docs/plugins.md |
| Pub/Sub with NATS Broker | docs/examples/learn-by-examples/pubsub-nats.md |
docs/examples/pubsub-nats.md |
| Quick Start | docs/guides/quickstart.md |
docs/quickstart.md |
| Registry | docs/interfaces/registry/index.md |
docs/registry.md |
| Roadmap | docs/project/roadmap.md |
docs/roadmap.md |
| Service Discovery with Consul | docs/examples/learn-by-examples/registry-consul.md |
docs/examples/registry-consul.md |
| Store | docs/interfaces/store.md |
docs/store.md |
| Summary: Reflection Removal Evaluation | docs/overview/REFLECTION-EVALUATION-SUMMARY.md |
docs/REFLECTION-EVALUATION-SUMMARY.md |
| TLS Security Update - Important Information | docs/overview/TLS_SECURITY_UPDATE.md |
docs/TLS_SECURITY_UPDATE.md |
| Transport | docs/interfaces/transport/index.md |
docs/transport.md |
All paths are relative to internal/website/content/en/. 23 duplicated titles across 47 files (Contributing has 3 copies).
Remove duplicate page titles in internal/website/content/en so every
title resolves to a single canonical page. Precedence: directory index
pages with bundled images, then the most complete content; draft copies
were dropped.
Removed duplicates (kept page in parentheses):
- docs/overview/*/index.md (dir index + image) vs docs/*.md for
ai-integration, architecture, config, getting-started, observability
- docs/interfaces/{broker,registry,transport}/index.md (dir index +
image) vs docs/{broker,registry,transport}.md
- docs/interfaces/{plugins,store}.md vs docs/{plugins,store}.md
- docs/contributing.md and docs/guides/contributing.md vs
docs/project/contributing.md
- docs/guides/quickstart.md vs docs/quickstart.md
- docs/overview/performance.md vs docs/performance.md
- docs/project/{roadmap,roadmap-2026}.md vs docs/roadmap.md
- docs/architecture/{index,adr-*}.md (already mirrored and kept in
docs/project/architecture/, whose index now links the available ADRs)
- docs/model.md vs docs/model/index.md
- blog/news/agent-guardrails.md vs docs/guides/agent-guardrails.md
- docs/examples/learn-by-examples/* (near-identical copies) vs
docs/examples/*
- docs/overview/{REFLECTION-EVALUATION-SUMMARY,TLS_SECURITY_UPDATE}.md
(draft copies)
- docs/index.md and docs/examples/index.md symlinks vs their _index.md
Frontmatter tidy: add missing descriptions (store, atlas-cloud, model),
drop weight/draft overrides, consolidate the Architecture Decision
Records index, and remove dead CSS overrides from _styles_project.scss.
Hugo conventions: _index.md is the branch/section bundle for a
directory - it is the landing page for a doc section that lists its
children. index.md is a leaf bundle - a standalone page at the exact
directory URL whose directory bundles its own resources (images, etc.).
The docs site standardizes on _index.md for section landing pages, so
the redundant index.md symlinks were removed and the duplicate
Architecture directory was merged into the project/architecture section.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.