Skip to content

Use guide index as homepage root#1

Merged
coisa merged 8 commits intomainfrom
feat/guides-home-redirect
Apr 19, 2026
Merged

Use guide index as homepage root#1
coisa merged 8 commits intomainfrom
feat/guides-home-redirect

Conversation

@coisa
Copy link
Copy Markdown
Contributor

@coisa coisa commented Apr 19, 2026

Summary

  • remove the template index.html transformation so the guide index document can become the root homepage when guide output is set to .
  • document that this template is designed for documentation sets that provide guides and should point guide output to the documentation root
  • harden local asset and navigation paths for guide-rendered pages by avoiding fragile base-href behavior and using explicit template paths where needed
  • fix search result links so local root pages resolve API links correctly

Validation

  • verified the final Twig and template changes against phpDocumentor writer behavior and the generated relative-path logic
  • reproduced and fixed the broken search URL concatenation in the template JavaScript
  • phpdoc / phpDocumentor CLI is not installed in this environment, so I could not run an end-to-end render locally

@coisa coisa changed the title Redirect homepage to guides when available Use guide index as homepage root Apr 19, 2026
@coisa coisa merged commit a1c6e26 into main Apr 19, 2026
@coisa coisa deleted the feat/guides-home-redirect branch April 19, 2026 22:32
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.

1 participant