Docs updated everyday?

Dear: Hello, Why "Last updated on" update everyday on the web " https://docs.python.org/zh-cn/3.8/download.html"? So if I want to read the latest docs, I havt do download them all everyday? Where can I find the changelog so that I can find the differences changed everyday? Looking forward to hearing from u. Thanks!

Hi,
Why "Last updated on" update everyday on the web "https://docs.python.org/zh-cn/3.8/download.html"?
This is because we're currently re-generating the HTML every 3 hours (and the PDF every day) [1].
So if I want to read the latest docs, I havt do download them all everyday?
No, we're rebuilding it every day, it changes slightly every day, but it's really only little fixes (a broken link, a better wording, a missing detail, ... so you don't need to download it every day, the differences will be unnoticable. You can redownload it "from time to time".
Where can I find the changelog so that I can find the differences changed everyday?
It's versionned using git, hosted on github [2], in a `Doc/` directory. If you just want to see what has been changed when, choose the right branch, click on Doc, you'll land here [3] and you'll see last change date for each directory and files. If you really want a changelog, you can clone the cpython repository: git clone https://github.com/python/cpython cd cpython switch to the branch you're interested in git checkout 3.8 and read what's changed in the Doc/ directory: git log --pretty=format:'%ci: %s' Doc/ it will look like this: 2020-02-04 16:32:32 -0800: bpo-39184: Add audit events to command execution functions in os and pty modules (GH-17824) 2020-02-03 09:17:17 -0800: bpo-38558: Link to further docs from walrus operator mention in tutorial (GH-16973) 2020-02-03 04:07:19 -0800: fixes typos in http.client documentation (GH-18300) 2020-01-29 05:17:40 -0800: Doc: Fix external links to functional programming tutorial. (GH-18249) 2020-01-29 03:29:35 -0800: bpo-39153: Clarify C API *SetItem refcounting semantics (GH-18220) 2020-01-28 02:18:09 -0800: bpo-39287: Doc: Add UTF-8 mode section in using/windows. (GH-17935) 2020-01-27 19:40:14 -0800: bpo-36018: Minor fixes to the NormalDist() examples and recipes. (GH-18226) (GH-18227) Or if you want to also see what changed: git log -p Doc/ Hope it helps! [1]: https://github.com/python/psf-salt/blob/master/salt/docs/init.sls#L83-L101 [2]: https://github.com/python/cpython [3]: https://github.com/python/cpython/tree/3.8/Doc Bests, -- Julien Palard https://mdk.fr
participants (2)
-
Cinshine Hsiang
-
Julien Palard