Update readthedocs.

[ryneeverett]

The current commit is a few years old (5f296a8) and doesn't correspond with a release so maybe this is configured in the readthedocs or github UI?

[ryneeverett]

https://readthedocs.org/projects/bugwarrior/builds/ warns:

The project bugwarrior-docs doesn't have a valid webhook set up, commits won't trigger new builds for this project. See the project integrations for more information.

[ryneeverett]

I created https://github.com/ryneeverett/bugwarrior-docs-mirroraction which is a repo that just contains a github actions workflow to run a daily cron job to update the mirror. Hopefully it works.

[wamserma]

The old documentation at https://bugwarrior.readthedocs.io is still up, which is a bit confusing for people looking up this project. Maybe get in contact with [email protected] to get this fixed.

[ryneeverett]

Thanks for the feedback @wamserma! I'm taking another shot at reaching out to other maintainers to see if we can recover the original readthedocs account first, but if that fails I will try to get it done by contacting the readthedocs team as you suggested.

[ryneeverett]

Hey @ralphbean, any chance you could help us out with one of the following:

1. fix the readthedocs build by enabling the webhook in this repository
2. redirect your bugwarrior.readthedocs.io to my up-to-date mirror bugwarrior-docs.readthedocs.io (not an ideal solution)
3. empower another maintainer with enough repository permission to enable the readthedocs webhook in this repository such as myself or @djmitche (this would be great regardless as your bus factor has been a bit of an issue)

[ralphbean]

@ryneeverett yes. I think I just successfully enabled the webhook. Can you confirm?

I'm 👍 to empower you or @djmitche, but I don't think I see a way to do it while the repo is still under my namespace. WDYT about moving it to an org so you two can be granted full ownership rights?

[ryneeverett]

I was thinking about suggesting moving it to https://github.com/GothenburgBitFactory if they'd accept it.

[djmitche]

I'd be into that! Maybe @tbabej is the person to actually approve it?

[ryneeverett]

I think I just successfully enabled the webhook. Can you confirm?

Next time we push to develop a new build should show up here or you could push the "Build Version" button by logging in to https://readthedocs.org/projects/bugwarrior.

However, the build will fail due to #1022. 🙃

[ryneeverett]

Well I pushed and it did not trigger a build.

[tbabej]

I'd be into that! Maybe @tbabej is the person to actually approve it?

I'd say moving community projects under GBF umbrella is something we're generally open to, in the past we moved tasklib as an example. Especially when it comes to important community projects, like bugwarrior.

@ralphbean reading the docs looks like it might be easiest if you transfer bugwarrior under tbabej/bugwarrior and I then move it under GothenburgBitFactory/bugwarrior

[ralphbean]

Makes sense, @tbabej. Transfer request initiated.

[tbabej]

Both transfer completed - bugwarrior is now hosted at https://github.com/GothenburgBitFactory/bugwarrior

[ryneeverett]

How do we want to handle pypi credentials so we can cut releases?

[ryneeverett]

This issue is now resolved and bugwarrior.readthedocs.io is now building and displaying the latest docs!

Regarding the dismantling of bugwarrior-docs.readthedocs.io:

• I have deleted https://github.com/ryneeverett/bugwarrior-docs.
• I'm changing project links back to bugwarrior.readthedocs.io in docs: Change links to bugwarrior.readthedocs.io #1026.
• I'm redirecting bugwarrior-docs.readthedocs.io to bugwarrior.readthedocs.io per these instructions. This has not taken effect yet but I'm assuming that's just readthedocs slowness. If this doesn't work I will just delete my readthedocs account and that will delete the project which will soon be outdated.