Skip to content

fix: #2580 - Add redirects for /doc and /docs to /guides - #2587

Open
lucasoliveira04 wants to merge 1 commit into
quarkusio:mainfrom
lucasoliveira04:fix-2580-docs-redirect
Open

fix: #2580 - Add redirects for /doc and /docs to /guides#2587
lucasoliveira04 wants to merge 1 commit into
quarkusio:mainfrom
lucasoliveira04:fix-2580-docs-redirect

Conversation

@lucasoliveira04

Copy link
Copy Markdown

Adds redirects for:

  • /doc → /guides
  • /docs → /guides

Motivation:
Some LLMs point to /doc as Quarkus documentation location.

@holly-cummins
holly-cummins requested a review from gsmet June 1, 2026 15:24
@holly-cummins

Copy link
Copy Markdown
Contributor

This looks like a good idea to me (thanks!), but we didn't get a preview to confirm things work. I'll leave it to @gsmet, since I don't make redirects very often.

@gsmet

gsmet commented Jun 1, 2026

Copy link
Copy Markdown
Member

Frankly, I'm not really excited about it. Not sure why LLMs would be confused. But I'm not strongly against it either.

@gsmet gsmet 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.

Do you have an example of an LLM pointing to the wrong page?

Also, I'm confused because the files don't seem to follow what we have in the other files such as: https://github.com/quarkusio/quarkusio.github.io/blob/main/_redirects/awards.md?plain=1 .

@holly-cummins

Copy link
Copy Markdown
Contributor

Frankly, I'm not really excited about it. Not sure why LLMs would be confused. But I'm not strongly against it either.

If we s/LLM/humans, it still seems like a good change to me. I'd expect https://quarkus.io/docs to not 404, since it's such a common url pattern and people might guess it works.

@gsmet

gsmet commented Jun 1, 2026

Copy link
Copy Markdown
Member

People are weird but fine :).

We need the file to be correct though and in line with what we have. I'm not sure they are, especially I don't know where redirect_to comes from?

@holly-cummins

holly-cummins commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

People are weird but fine :).

We need the file to be correct though and in line with what we have. I'm not sure they are, especially I don't know where redirect_to comes from?

Oh, agreed – I wasn't commenting on the actual change contents (which I'm completely unqualified to do), just on the principle that /docs is a nice url and we should have one of our own. :)

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.

3 participants