Fix broken links in the Devguide

[Mariatta]

Looks like the Link check step in the CI is broken. It has always been allowed to fail for a long time.
Would be great to fix them all.

Please see the output here:
https://github.com/python/devguide/runs/2463428458?check_suite_focus=true

While looking at the output, I noticed that pypy.org is listed as broken. I think that's the correct url though. I've filed the issue here:

pypy/pypy.org#23
Update: the url seems to work now.

But it would be good to look through the rest and update the urls accordingly.

[Mariatta]

I think it would be great if link check becomes a required CI check, once we fixed all the urls.

[himanshu007-creator]

Hi, i would like to fix the broken links. Please assign me this issue

[Mariatta]

We don't assign issues to non core developers. You can just start creating the PR and we go from there.

[himanshu007-creator]

There are total 11 broken links. I have fixed 6 of 'em. But there are some links i would like to ask about.

this and this link point to same website and this website just shows a white screen

This metadata is not available as mentioned in issue

This link doesn't work because the repo is either made private or deleted

This website shows a 522 error

I would like to know how should they be resolved.

[Mariatta]

This website shows a 522 error

Looks like gmane.org moved to https://gmane.io/

This link doesn't work because the repo is either made private or deleted

Yes the python/voters repo is a private repo that is available for Python core devs only. So it looks like we will have to allow that the linkcheck to be broken :( Is there a way to tell sphinx linkcheck to ignore this specific url?

This metadata is not available as mentioned in issue

Hmm yes, I also don't know what the correct URL is. It has been discussed previously in
#456.

Does anyone know where is the the Issue tracker for the tracker is? I thought that it's now being tracked at github.com/python/bugs.python.org, but this is the issue tracker for our own instance of it. It sounds like there is another issue tracker just for Roundup. But I don't know where that is.

this and this link point to same website and this website just shows a white screen

Those are Phillip Guo's websites. Seems like it's not active anymore. I'm not sure if they have another website now.
Perhaps we can either remove the links, or point to a different resource.

I understand that there are still broken links, however, if you can just start opening the pull request with the fixes that you've made, I think it would bring us to a better place already. We can continue fixing the broken links later.

[Mariatta]

There is a way to tell linkcheck to ignore urls. The documentation is here:
https://www.sphinx-doc.org/en/master/usage/configuration.html?highlight=linkcheck#options-for-the-linkcheck-builder

Perhaps we need to add the python/voters url to it.

[hugovk]

Does anyone know where is the the Issue tracker for the tracker is? I thought that it's now being tracked at github.com/python/bugs.python.org, but this is the issue tracker for our own instance of it. It sounds like there is another issue tracker just for Roundup. But I don't know where that is.

Is it https://issues.roundup-tracker.org/ ?

[Mariatta]

Yes it looks like it.

[pratyaksh1610]

I am new to open source . Can you guide me through the journey ?
How can I resolve my first issue ?

[pratyaksh1610]

@Mariatta

[jablonskidev]

@pratyaksh1610 If you're looking for guidance on how to find and fix your first issue, you can check out this resource: https://realpython.com/start-contributing-python/

[Noel-Voelin]

As far as I see, this issue is resolved. @Mariatta can you please close this or update with what is needed? Thanks!