Documentation link on PyPi is broken

[basilevs]

Bug Report

On page https://pypi.org/project/PasteDeploy/ in Project links section "Documentation" link leads to https://docs.pylonsproject.org/projects/pastedeploy/en/latest/ which produces HTTP 404 error.

To Reproduce
Steps to reproduce the behavior:

1. Go to https://pypi.org/project/PasteDeploy/
2. Click on Documentation
3. See error 404

Expected behavior
Some kind of documentation

Screenshots

[stevepiercy]

There's a squatter on both the Pylons Project project names pastedeploy and paste using the old BitBucket repos on RTD.

• https://readthedocs.org/profiles/ilseedavid/
• https://readthedocs.org/projects/pastedeploy/
• https://readthedocs.org/projects/paste/

The Pylons Project can start a claim with RTD per this process, which takes up to 6 weeks:

https://docs.readthedocs.io/en/stable/abandoned-projects.html

Alternatively someone can contact the squatter and ask them nicely to unsquat.

I happen to know this because I recently started the process for Plone.

[basilevs]

Should not the broken links be removed from

pastedeploy/setup.cfg

Line 39 in c131649

Documentation = https://docs.pylonsproject.org/projects/pastedeploy/en/latest/

?

[stevepiercy]

Perhaps temporarily until the project name is reclaimed.

[DeepeshKalura]

I found the documents, but I think they are quite old. Here is the link: https://pastedeploy.readthedocs.io/en/latest/ . In the picture, you can see it was discussing version 1.0, which is currently outdated. If you want to read the documents, it might still be helpful.

[mmerickel]

I have opened a support request with RTD.

I am considering an alternative where maybe we can proxy things, but I'm not sure it'll actually work. We could claim pastedeploy-official and then setup our nginx config to rewrite pastedeploy to pastedeploy-official possibly. I'm worried that it wouldn't work correctly with the little embedded popup on the page though. I've asked them for some guidance.

[mmerickel]

Through my support request they gave me control of the RTD project. I'll work on fixing this up and integrating it into our structure soon.

[mmerickel]

@stevepiercy I also added you as a maintainer if you have any desire to sort out RTD config.

[stevepiercy]

@mmerickel thanks, invite accepted. I have a backlog of open source docs reviews, so maybe next week.

[stevepiercy]

@mmerickel @digitalresistor I don't recall how to set up the bits and pieces for https://docs.pylonsproject.org/projects/pastedeploy/en/latest/ to point to https://pastedeploy.readthedocs.io/latest/. IIRC, these is handled on the Linode.

Other than that, the docs are building with the latest version.

I can also set up pull request previews, if desired. I've been doing that for Plone, so it's a habit now.

[digitalresistor]

@mmerickel @digitalresistor I don't recall how to set up the bits and pieces for https://docs.pylonsproject.org/projects/pastedeploy/en/latest/ to point to https://pastedeploy.readthedocs.io/latest/. IIRC, these is handled on the Linode.

Other than that, the docs are building with the latest version.

I can also set up pull request previews, if desired. I've been doing that for Plone, so it's a habit now.

Nope, not handled on Linode. It's handled on the RTD side of things.

[digitalresistor]

Gotta add it as a subproject here: https://app.readthedocs.org/dashboard/pylons/subprojects/

I don't have access to the paste deploy project so I can't add it.

[mmerickel]

I've added it as a subproject now and invited you.

[stevepiercy]

In https://app.readthedocs.org/dashboard/pastedeploy/edit/ :

• I set the default branch to main.
• The default version is "latest", which is the content from the main branch.
• I changed "URL versioning scheme" to "Multiple versions with translations" (which is silly because there are no translations for any Pylons Project projects) 🤡 .
• I rebuilt "latest". Success! https://docs.pylonsproject.org/projects/pastedeploy/en/latest/
• There is a "stable" version that fails to build. RTD selected the commit of 83ba75ca, which was the last release, as described in https://docs.readthedocs.io/en/stable/versions.html#versions-are-git-tags-and-branches. A new release will pick up the .readthedocs.yaml file from main and should build successfully. @mmerickel @digitalresistor would one of you please do the honors? Thank you!