Jak sprawdzić, czy istnieją zmiany/ulepszenia w dokumentacji CPython

Question

Sekcje "Co nowego", tablice ogłoszeń, społeczność itp. Są świetne, ale co się stanie, gdy przeczytane przeze mnie odwołanie będzie mi znane i może nigdy spójrz na to ponownie (lub myśl, że nie muszę), dostaje znaczącą aktualizację. Obawiam się, że potencjalnie pomijam sens czegoś użytecznego, gdy powstają nowe, wnikliwe przykłady lub bardziej kompletna dokumentacja. Być może nawet usunięcie niepoprawnej lub mylącej dokumentacji (GASP!).

Nie zrozumcie mnie źle, między wyszukiwarką Google, przepełnieniem stosu, dokumentami PEP i dobrze powiązaną dokumentacją, zazwyczaj jestem w stanie uzyskać tak dużo szczegółów, jak chcę, bardzo szybko. W miarę jak poznaję język, z pewnością chciałbym przejrzeć udoskonalenia takiej dokumentacji, jeśli jest to coś, z czego często korzystam.

Czy istnieje zasób, którego mogę użyć, aby już znaleźć ten rodzaj informacji?

Answer 1

Jeśli funkcje zostały dodane lub zmienione, dodajemy do dokumentów dokumenty "zmieniona wersja" lub "wersja dodana".

Jeśli chcesz (jak to brzmi) monitorować miejsca, w których ulepszamy dokumenty, to jednym ze sposobów jest zasubskrybowanie listy mailingowej python-checkins i dodanie filtru do programu pocztowego do przechwytywania tylko checkiny, które aktualizują poddrzewo Doc.

Alternatywnie można zrobić hg kasy projektu i okresowo uruchamiać "hg log" w poddrzewie Doc, a następnie przyjrzeć się bliżej jakiejkolwiek wersji, która Cię interesuje.

Lub, po złożeniu zamówienia, można okresowo dokonać "hg diff" katalogu Doc między ostatnią wersją, w której to zrobiłeś, a wersją bieżącą.

Answer 2

Aby sprawdzić, które pliki i jak wiele się zmieniło od danej rewizji:

$ hg diff --stat -r v3.3.0a1 Doc 
Doc/library/copyreg.rst | 8 ++++-- 
Doc/library/pickle.rst | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
2 files changed, 66 insertions(+), 3 deletions(-) 

Aby przejrzeć zmiany:

$ hg diff -r v3.3.0a1 Doc | less 

Jeśli znalazłeś ciekawe zmiany mogłyby view them online.