Come vedere quando ci sono cambiamenti/miglioramenti nella documentazione di CPython

Question

Le sezioni "What's new", bacheche, community, ecc. Sono grandiose, ma cosa succede quando ho letto un riferimento, ho familiarità con e mai guarda di nuovo (o pensa che non sia necessario), ottiene un aggiornamento significativo. Temo che possa potenzialmente mancare il punto di qualcosa di utile quando vengono creati alcuni nuovi esempi penetranti o una documentazione più completa. Forse, anche la rimozione di documentazione errata o confusa (GASP!).

Non fraintendetemi, tra Ricerca Google, Stack Overflow, PEP e la documentazione ben collegata, di solito sono in grado di ottenere tutti i dettagli che voglio, molto rapidamente. MA, acquisendo familiarità con la lingua, mi piacerebbe sicuramente rivedere i miglioramenti a tale documentazione, se è qualcosa che uso spesso.

Esiste una risorsa che posso utilizzare per trovare già questo tipo di informazioni?

Answer 1

Se le funzionalità vengono aggiunte o modificate, aggiungiamo le voci "versione modificata" o "versione aggiunta" ai documenti.

Se vuoi (come sembra) monitorare i luoghi in cui miglioriamo i documenti, un modo sarebbe iscriversi alla mailing list di Python-checkin e aggiungere un filtro al tuo programma di posta elettronica per acquisire solo check-in che aggiornano la sottostruttura Doc.

In alternativa è possibile eseguire un controllo hg del progetto e eseguire periodicamente "hg log" contro la sottostruttura Doc e quindi osservare più da vicino eventuali revisioni che ti interessano.

Oppure, avendo il checkout, è possibile eseguire periodicamente un 'hg diff' della directory Doc tra l'ultima revisione in cui è stata eseguita questa operazione e la versione corrente.

Answer 2

per vedere quali file e quanto sono stati modificati dopo una data di revisione:

$ 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(-) 

di sfogliare le modifiche:

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

interessanti cambiamenti Se avete trovato voi potrebbe view them online.