readthedocs / readthedocs.org

The source code that powers readthedocs.org
https://readthedocs.org/
MIT License
7.93k stars 3.58k forks source link

`source` being appended to rtd builds? #11384

Open dylanh724 opened 1 month ago

dylanh724 commented 1 month ago

Details

My dir tree:

To access foo.rst locally in a toctree, it's content/foo

To access foo.rst in your hosted RST build, it's source/content/foo (as if there's an extra source dir).

Expected Result

Local and RTD should map almost 1:1; I'm not sure what's going on with the "extra" source dir.

Actual Result

Eg:

For som reason, RST adds the extra source dir. I can either have successful local builds or rtd builds, but not both.

dylanh724 commented 1 month ago

What's odd is that I had a demo of it working in both local and rtd 1:1 -- I tried reverting back and it oddly didn't work (same bug). It's as if RTD just updated and inadvertently appended a source dir. I really want it to be me, but how can I possibly inadvertently add an extra source dir that only shows in rtd and not local?

dylanh724 commented 1 month ago

image

stsewd commented 1 month ago

Hi, please provide the URL of your project on RTD so we can help you.

dylanh724 commented 1 month ago

Hi, please provide the URL of your project on RTD so we can help you.

Ah, I don't think I'm allowed to, yet. Does this mean checkouts/latest/source/source with the double source is unique to my project, somehow?

Last week, this double source didn't exist. I tried reverting to last week's working rtd and there's still a source/source, leading me to believe there may have been a hosted update bug?

If there was no such update, I'll go back to figuring out what's going on, but just wanting to fact check! Thanks.

dylanh724 commented 1 month ago

There really was an update on June 4th and the 28th, hmm:

https://docs.readthedocs.io/en/stable/changelog.html

Mine last worked late May 27: Seems there were two patches since then. Hmm.

stsewd commented 3 weeks ago

Ah, I don't think I'm allowed to, yet. Does this mean checkouts/latest/source/source with the double source is unique to my project, somehow?

Note that projects on readthedocs.org are public, anyone can see them. We haven't received any other reports related to this, without a build to look at, there isn't much we can do to help or debug this.

Mine last worked late May 27: Seems there were two patches since then. Hmm.

Did a quick look, and don't see anything relevant that may have affected that.