docs refresh bug

[vinckr]

Describe the bug

If I go to Zero Trust with IAP Proxy and scroll down to #cookie-session-authenticator and click the link "to ORY Kratos' /sessions/whoami API."
Then everything works correctly and I end up at https://www.ory.sh/kratos/docs/reference/api/
But if I reload the page now and click the same link again, I get routed to : https://www.ory.sh/kratos/docs/guides/reference/api and get a 404.

Reproducing the bug
Go to "https://www.ory.sh/kratos/docs/guides/zero-trust-iap-proxy-identity-access-proxy"
if you reload the page it turns into: "https://www.ory.sh/kratos/docs/guides/zero-trust-iap-proxy-identity-access-proxy/"
Click the link at https://www.ory.sh/kratos/docs/guides/zero-trust-iap-proxy-identity-access-proxy/#cookie-session-authenticator.
You get redirected to 404.

Expected behavior
I should end up at https://www.ory.sh/kratos/docs/reference/api/.
But if I reload the page I get routed to : https://www.ory.sh/kratos/docs/guides/reference/api and get a 404.

Additional context

This seems to stem from the / that is added to the URL after the reload.

[aeneasr]

I can not reproduce this any more, I think we have resolved issues with trailing slashes!

[vinckr]

For me the issue is still there @aeneasr
I just searched something via google, got sent to:
https://www.ory.sh/hydra/docs/jwks/
and the links to reference API are broken
because of the added trailing slash.

When I leave and re-enter the page through the navbar everything works correctly.

The issue only comes up when you come to the docs from an outside link like google ect.
Its not terrible, just wanted to record it.

[aeneasr]

@vinckr I believe the problem is that the link does not include the .md or .mdx filename so docusaurus thinks we're linking to a randomg page, not to a document. If you find these links - search for the filename (e.g. api.md) and add the appendix. Please document this in ory/docs as part of "contributing -> how to write documentation -> how to add links to other docs pages"

[vinckr]

Sounds reasonable. I will add some info on that. I will go over the links.

[vinckr]

What also results in 404

• go to https://www.ory.sh/hydra/docs/concepts/login

• click the headline (to copy the url), your url changes to https://www.ory.sh/hydra/docs/concepts/login/#login-sessions-prompt-max_age-id_token_hint

• now try and click the link to configuration, it should lead to https://www.ory.sh/hydra/docs/concepts/consent/

• but I end up at https://www.ory.sh/hydra/docs/concepts/login/consent

• Also whenever a page is reloaded, the /gets appended and breaks all internal links on the page.

The way to browse the docs safely, is to use the sidebar navigation.

Seems like the same issue, but I have no idea how to fix it.

[vinckr]

This also seems to be fixed, was not able to reproduce it in the above cases.
If it crops up again, we can fix it with by adding the .md etc. extensions