Skip to content

Fix Hugo documentation links: homepage URLs, missing sections, and broken references#19

Merged
awagner-mainz merged 4 commits intomainfrom
copilot/fix-homepage-links-issue
Feb 8, 2026
Merged

Fix Hugo documentation links: homepage URLs, missing sections, and broken references#19
awagner-mainz merged 4 commits intomainfrom
copilot/fix-homepage-links-issue

Conversation

Copy link
Contributor

Copilot AI commented Feb 8, 2026

Hugo documentation had broken links on homepage (missing /embapi/ base path), unlisted sections, and references to non-existent files.

Changes

Homepage (docs/content/_index.md)

  • Changed absolute paths to relative paths to respect Hugo's baseURL
    • /getting-started/getting-started/
    • /api/api/
    • etc.
  • Added missing sections: Development, Deployment, Reference

Guides index (docs/content/guides/_index.md)

  • Linked all 8 individual guides (RAG Workflows, Project Sharing, Public Projects, Ownership Transfer, Metadata Validation, Metadata Filtering, Batch Operations, Instance Management)

Concepts index (docs/content/concepts/_index.md)

  • Linked all 7 key components (Users, Projects, Embeddings, LLM Services, Similarity Search, Metadata, Architecture)

Broken references

  • api/authentication.md: /docs/PUBLIC_ACCESS.md../../guides/public-projects/
  • api/endpoints/projects.md: /docs/PUBLIC_ACCESS.md../../guides/public-projects/
  • api/endpoints/llm-services.md: /docs/LLM_SERVICE_REFACTORING.md../../concepts/llm-services/ and ../../reference/database-schema/

Example

Before:

- [Getting Started](/getting-started/) - Installation and first steps

After:

- [Getting Started](getting-started/) - Installation and first steps
- [Deployment](deployment/) - Production deployment guide
- [Development](development/) - Contributing and development guide

Screenshots

Homepage with fixed links and added sections:
Homepage

Guides page with all items linked:
Guides

Concepts page with all components linked:
Concepts

Original prompt

In the docs/hugo website, the links on the homepage are missing the repository name component, i.e. they point to https://mpilhlt.github.io/api/ instead of https://mpilhlt.github.io/embapi/api/ (in the other pages, it seems to be correct). Also, not all areas are linked from the homepage, e.g. development is not, I think there are others that are missing as well. The individual guides in the user guides section are listed but not linked, the same for the key components on the concepts page. Please check that all links are linked and that they point to the correct page/anchor.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 3 commits February 8, 2026 22:42
Co-authored-by: awagner-mainz <2088443+awagner-mainz@users.noreply.github.com>
Co-authored-by: awagner-mainz <2088443+awagner-mainz@users.noreply.github.com>
Co-authored-by: awagner-mainz <2088443+awagner-mainz@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix missing repository name in homepage links Fix Hugo documentation links: homepage URLs, missing sections, and broken references Feb 8, 2026
Copilot AI requested a review from awagner-mainz February 8, 2026 22:48
@awagner-mainz awagner-mainz marked this pull request as ready for review February 8, 2026 22:52
@awagner-mainz
Copy link
Contributor

Looks good.

@awagner-mainz awagner-mainz merged commit 2b50906 into main Feb 8, 2026
1 check passed
@awagner-mainz awagner-mainz deleted the copilot/fix-homepage-links-issue branch February 8, 2026 22:53
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