Django
Meta: linee guida per la documentazione
Ricerca…
Osservazioni
Questa è un'estensione di "Meta: Documentation Guidelines" di Python per Django.
Queste sono solo proposte, non raccomandazioni. Sentiti libero di modificare qualsiasi cosa qui se non sei d'accordo o hai qualcos'altro da dire.
Le versioni non supportate non richiedono menzioni speciali
È improbabile che qualcuno usi una versione non supportata di Django, ea proprio rischio. Se mai qualcuno lo fa, deve preoccuparsi di sapere se esiste una funzionalità nella versione fornita.
Considerando quanto sopra, è inutile menzionare le specificità di una versione non supportata.
Questo tipo di blocco è inutile perché nessuna persona sana di mente usa Django <1.6.
Questo tipo di blocco è inutile perché nessuna persona sana di mente usa Django <1,8.
Questo vale anche per gli argomenti. Al momento della stesura di questo esempio, le viste basate sulla classe 1.3-1.9
versioni supportate sono 1.3-1.9
. Possiamo tranquillamente supporre che questo sia effettivamente equivalente a All versions
. Questo evita anche l'aggiornamento di tutte le versioni supportate da argomenti ogni volta che viene rilasciata una nuova versione.
Le versioni supportate correnti sono:
1.8
11.9
21.10
1
- Correzioni di sicurezza, bug di perdita di dati, bug che si bloccano, bug di funzionalità importanti nelle funzionalità appena introdotte e regressioni da versioni precedenti di Django.
- Correzioni di sicurezza e bug di perdita di dati.