Update docs about automatic redirect when converting a multi-version project to single-version
See original GitHub issueDetails
- Read the Docs project URL: https://readthedocs.org/projects/spinalcordtoolbox/
- Build URL (if applicable): https://readthedocs.org/projects/spinalcordtoolbox/builds/14723739/
- Read the Docs username (if applicable): joshuacwnewton
I recently enabled the “single version” setting on the spinalcordtoolbox
project. As a result, the default URL for our project switched from https://spinalcordtoolbox.com/en/latest/ to https://spinalcordtoolbox.com/.
Expected Result
The RTD documentation for Single version states:
Documentation at
/<language>/<default_version>/
will still be served for backwards compatibility reasons.
So, I expected all of the previous https://spinalcordtoolbox.com/en/latest/*
links (our old default) to still be served.
Actual Result
All of the https://spinalcordtoolbox.com/en/latest/*
links now lead to 404 pages.
Issue Analytics
- State:
- Created 2 years ago
- Comments:6 (3 by maintainers)
Top Results From Across the Web
Enable or disable autogenerated binding redirects
Right-click the project in Solution Explorer and select Properties. · On the Application page, uncheck the Auto-generate binding redirects option ...
Read more >User-defined Redirects
Go to the Admin tab of your project. · From the left navigation menu, select Redirects. · In the form box “Redirect Type”...
Read more >Project Settings
To export your docs, click on Configuration > Project Settings, ... you can use example zipped files for single version and multi version...
Read more >Redirects and Google Search
Redirecting URLs is the practice of resolving an existing URL to a different one, effectively telling your visitors and Google Search that a ......
Read more >Create a redirect test - Optimize Resource Hub
A redirect test contains different URLs for each variant. Redirect tests are useful when you want to test multiple different landing pages, or...
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
Yea, I’d like to just remove that copy, and suggest a redirect. We don’t want to do this magically.
I wasn’t even aware of that text, looks like it was added a long time ago https://github.com/readthedocs/readthedocs.org/blob/72037c0b7909d491389da68d7b7019d184901815/docs/single_version.rst
So, not sure if this was working before (we don’t track if a project has been converted from multiple versions to single-version), but yeah, we don’t try to serve those URLs currenlty (en/latest is taken as a file).
https://github.com/readthedocs/readthedocs.org/blob/135025f2a40ad7dfbaabda1261ee048a84e44a72/readthedocs/proxito/views/utils.py#L59-L67
So, we could keep the text and maybe create a redirect for the user or remove the text and suggest users to create a redirect by themselves. /cc @ericholscher