Comments (5)
Yes as mentionned by @hugovk it's fixed since 2017 but it could still happen in very unfortunate conditions.
To be very precise:
- Today we don't use "html-only builds", so if the script crash nothing gets updated at all on docs.python.org (old files are kept, new files are not added).
- This year, when it happened (see #124), we were triggering hourly "html-only builds" for
/dev/
because devs like fast updates and we still don't have python/psf-salt#226.
If python/psf-salt#226 gets done, or if any experience using html-only builds are done, AND a crash happen during the PDF build, it would result in the following situation:
- HTML get updated by html-only builds
- old files are not deleted
(Old files are not deleted by html-only builds because it would delete PDFs...)
Hopefully build errors are monitored using Sentry, I don't know who receive the notifications though, I know I receive them and I bet Ee receives them.
from docs-community.
Thanks. The issue seems to be resolved and presumably can be closed, as it seems in the intervening 8 years the adoption of the modern Sphinx rendering system and the hosting backend have resulted in documentation being appropriately deleted when it no longer exists in the source, as the link doc no longer exists and gives a 404, even for Python 3.4.
from docs-community.
Hm, was there a change to the hosting backend? I know nothing about these things.
Do we know for sure files are being deleted, or should we double-check (and if so, where?)
from docs-community.
It happened in February with 3.11 due to a PDF build failure and some caching problems:
And earlier in 2017, fixed by changing a cp
to rsync
(but keeping cp
for archives):
Ping also @JulienPalard.
from docs-community.
Ah, OK. I think it's fine if an emergency workaround build system keeps deleted files, as long as regular builds are fine. Thanks for confirming!
from docs-community.
Related Issues (20)
- Document the Editorial Board in this repo HOT 1
- Style guide: permit "CPU"? HOT 10
- Review bpo-21314: Document '/' in signatures HOT 2
- Review bpo-40245: Add description meta tags to docs.python.org HOT 1
- Review bpo-43614: Search is not beginner friendly HOT 4
- Review bpo-36329: use the right python "make -C Doc/ serve" HOT 3
- Review bpo-36795: "make venv" failed in Docs HOT 1
- Review bpo-23312: google thinks the docs are mobile unfriendly HOT 1
- Changing docs for trivial issues HOT 28
- Style guide suggestion: Avoid duplicate links HOT 28
- Migrate these docs to docs-community.python.org HOT 11
- Add automation to prevent breaking URLs HOT 2
- Research ways to improve SEO HOT 8
- Analyse docs.python.org using Google Search Console HOT 1
- Add meta tags to docs.python.org HOT 6
- Add release cycle chart HOT 12
- Re-enable deprecation warnings HOT 3
- [PyCon 2024] Documentation summit and Documentation sprint HOT 5
- Help needed: Community platform HOT 3
- Cut the whale of the changelog into manageable pieces? HOT 8
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs-community.