FAQ page is still in docs.python.org/devguide

[Mariatta]

FAQ section was removed in GH-27
Recently docs.python.org/devguide has been updated to reflect the github branch.

Somehow this page is still alive 😅
https://docs.python.org/devguide/faq.html

Any idea of what should be done?

The FAQ is referenced in https://docs.python.org/3/faq/general.html and this issue is related to python/cpython#8

[brettcannon]

Just delete it again. 😄

[ned-deily]

I believe the problem is that the docs build job doesn't remove deleted pages. I'll ask infra to manually remove it and also the patch.html page.

[ned-deily]

OK, https://docs.python.org/devguide/faq.html and https://docs.python.org/devguide/patch.html are now gone; you might need to refresh your browser to get the 404.

It might make sense to turn this issue into a request to get the docsbuild script to remove deleted pages when updating the on-line html (if such an issue does not already exist; this isn't the first time something like this has happened).

[brettcannon]

python/core-workflow#4 is about moving the devguide to Read the Docs and then adding a subdomain on python.org for the devguide. That would alleviate the custom infrastructure dependency.

[ned-deily]

The problem with deleted pages isn't limited to the devguide. It affects all docs builds.

[Mariatta]

Thanks @ned-deily
I'm not familiar with docsbuild script. Do you mean that the issue is something to be reported to https://github.com/sphinx-doc/sphinx/ ? If so, I will file a bug there :)

btw I just checked https://docs.python.org/devguide/faq.html and https://docs.python.org/devguide/patch.html both are still active. Could there be caching issue?

[zware]

@Mariatta See https://github.com/python/docsbuild-scripts for the script that triggers the builds of everything on docs.python.org.

[Mariatta]

Aha! Thanks @zware will check it out :)

[ned-deily]

Grrr! They were deleted yesterday but I think the files came back because they also need to be deleted from the docs build directory that probably just gets copied over to the directory from which they are served (I don't have read access to the build directory). I've asked the admins to remove both sets. Hopefully, that will make them permanently go away.

[ned-deily]

The two pages are now gone again, with luck they will stay that way this time. Since you've opened the issue under docsbuild-scripts, I guess we can close this one?

[Mariatta]

Sounds good :)