question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Update docs about automatic redirect when converting a multi-version project to single-version

See original GitHub issue

Details

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:closed
  • Created 2 years ago
  • Comments:6 (3 by maintainers)

github_iconTop GitHub Comments

1reaction
ericholschercommented, Sep 15, 2021

Yea, I’d like to just remove that copy, and suggest a redirect. We don’t want to do this magically.

1reaction
stsewdcommented, Sep 15, 2021

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

Read more comments on GitHub >

github_iconTop 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 >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found