# Documentation Django 5.2.8

# Processus de publication de Django

## Publications officielles

Depuis la version 1.0, la numérotation des versions de Django fonctionne comme ceci :

- Les versions sont numérotées sous la forme `A.B` ou `A.B.C`.

- `A.B` est le numéro de version de publication majeure. Chaque version est rétrocompatible autant que possible avec la version précédente. Les exceptions à cette règle sont énumérées dans les notes de publication.

- `C` est le numéro de version corrective, qui est incrémenté pour les corrections de bogues et de sécurité. Ces publications sont 100% rétrocompatibles avec les précédentes versions correctives. La seule exception concerne les cas où un problème de sécurité ou de perte de données ne peut pas être résolu sans casser la rétrocompatibilité. Si cela se produit, les notes de publication donnent alors des instructions de mise à jour détaillées.

- Avant une nouvelle publication majeure, des publications alpha, beta et d’évaluation sont diffusées. Elles sont numérotées sous la forme `A.B alpha/beta/rc N`, ce qui signifie la `Nième` version alpha/beta/d’évaluation de la version `A.B`.

Dans git, chaque version de Django possède un « tag » nommé selon son numéro de version, signé avec la clé de publication de Django. De plus, chaque série de versions possède sa propre branche, appelée `stable/A.B.x`, et les publications corrigeant des anomalies ou des failles de sécurité sont produites à partir de ces branches.

For more information about how the Django project issues new releases for security purposes, please see our security policies.

Publication majeure

  Les publications majeures (A.B, A.B+1, etc.) apparaissent environ tous les huit mois, voir processus de publication pour les détails. Ces publications contiennent de nouvelles fonctionnalités ainsi que des améliorations à celles déjà existantes, entre autres.

Publication corrective

  Les publications correctives (A.B.C, A.B.C+1, etc.) sont diffusées si nécessaire, pour corriger des anomalies ou des problèmes de sécurité.

  Ces publications sont 100% compatibles avec la version majeure à laquelle elle correspond, sauf si c’est impossible en raison de problèmes de sécurité ou de pertes de données. Ainsi, la réponse à la question « dois-je mettre à jour à la dernière publication corrective ? » est toujours « oui ».

Publication avec prise en charge à long terme

  Certaines publications majeures sont désignées comme des versions prises en charge à long terme (LTS). Celles-ci vont recevoir les correctifs de sécurité et liées aux pertes de données pendant une durée garantie, habituellement pendant trois ans.

  Voir la page de téléchargement pour connaître les publications désignées comme prises en charge à long terme.

## Rythme de publication

À partir de la version 2.0, les numéros de version utilisent une forme libre du versionnement sémantique de façon à ce que chaque version suivant une LTS recommence à la prochaine version « point zéro ». Par exemple : 2.0, 2.1, 2.2 (LTS), 3.0, 3.1, 3.2 (LTS), etc.

SemVer facilite la détection au premier coup d’œil de la compatibilité des versions les unes avec les autres. C’est aussi une aide pour anticiper le moment où les blocs de compatibilité seront supprimés. Il ne s’agit pas d’une forme pure de SemVer, car chaque version majeure continue de comporter quelques incompatibilités documentées lorsqu’un chemin d’obsolescence n’est pas possible ou que le coût en serait trop élevé. De plus, les obsolescences démarrées lors d’une version LTS (X.2) sont supprimées dans une version non .0 (Y.1) pour correspondre à notre politique de conservation des blocs de compatibilité durant au minimum deux version majeures. Lisez la section suivante qui comporte un exemple.

## Politique d’obsolescence

Une version majeure peut rendre obsolètes certaines fonctionnalités de versions précédentes. Si une fonctionnalité est rendue obsolète lors de la version majeure `A.x`, elle continuera de fonctionner dans toutes les versions `A.x` (quel que soit x), mais produira des avertissements. Les fonctionnalités obsolètes seront supprimées dans la version B.0, ou B.1 pour les fonctionnalités rendues obsolètes dans la dernière version A.x afin de s’assurer que les avertissements d’obsolescence apparaissent au minimum dans deux versions majeures.

Par exemple, si nous décidons de rendre obsolète une fonction dans Django 4.2 :

- Django 4.2 contiendra une copie rétrocompatible de la fonction, mais en déclenchant un avertissement `RemovedInDjango51Warning`.

- Django 5.0 (la version qui suit 4.2) contiendra encore la copie rétrocompatible.

- Django 5.1 supprimera totalement la fonction.

Les avertissements sont silencieux par défaut. Vous pouvez faire afficher ces avertissements avec l’option `-Wd` de Python.

Un exemple plus générique

- X.0

- X.1

- X.2 LTS

- Y.0 : abandon des blocs de compatibilité ajoutés dans X.0 et X.1.

- Y.1 : abandon des blocs de compatibilité ajoutés dans X.2.

- Y.2 LTS : aucune suppression de bloc de compatibilité (même si Y.0 n’est plus prise en charge, les applications tierces doivent maintenir la compatibilité avec X.2 LTS pour faciliter les transitions de LTS à LTS).

- Z.0 : abandon des blocs de compatibilité ajoutés dans Y.0 et Y.1.

Voir aussi le guide Obsolescence d’une fonctionnalité.

## Versions prises en charge

À tout instant, l’équipe de développement de Django prend en charge un ensemble de versions à différents degrés. Consultez la section des versions prises en charge de la page de téléchargement pour connaître l’état actuel de prise en charge de chaque version.

- La branche `main` de développement reçoit les nouvelles fonctionnalités et les corrections de bogues qui nécessitent des révisions de code non triviales.

- Les correctifs appliqués à la branche `main` doivent également être appliqués à la dernière branche de publications stables, afin d’être publiés lors de la version corrective suivante de cette série, s’ils concernent des corrections de problèmes critiques :

  - Failles de sécurité.

  - Bogues provoquant des pertes de données.

  - Bogues provoquant des plantages.

  - Des bogues fonctionnels majeurs dans des nouvelles fonctionnalités de la dernière version stable.

  - Des régressions par rapport aux versions précédentes de Django introduites dans la série actuelle de publications.

  La règle de base est que des corrections sont rétroportées vers la dernière version stable s’il s’agit de bogues qui auraient bloqué une publication normale (bloqueurs de publication).

- Les correctifs de sécurité et les bogues de perte de données sont appliqués à la branche `main` actuelle, aux deux dernières branches de version stable et à toute autre branche faisant partie d’une prise en charge à long terme (LTS).

- Les corrections de documentation seront généralement rétroportés plus facilement vers la branche de publication. Ceci parce qu’il est grandement avantageux d’avoir la documentation de la dernière publication à jour et correcte, et le risque d’introduire des régressions est beaucoup moins présent.

Comme exemple concret, considérez un moment dans le temps à mi-chemin entre les publications Django 5.1 et 5.2. À cet instant-là :

- Les fonctionnalités seront ajoutées à la branche principale de développement, afin d’être publiées dans Django 5.2.

- Les corrections de bogues critiques seront appliqués à la branche `stable/5.1.x` et publiées en tant que 5.1.1, 5.1.2, etc.

- Les corrections de sécurité et les corrections de bogues entraînant des pertes de données seront appliquées aux branches `main`, `stable/5.1.x`, `stable/5.0.x` et `stable/4.2.x` (LTS). Elles amèneront aux publications de `5.1.1`, `5.0.5`, `4.2.8`, etc.

- Les corrections de documentation seront appliquées à la branche `main`, et, si elles peuvent facilement être rétroportées, également à la dernière branche stable, `5.1.x`.

## Processus de publication

Django suit un calendrier de publication à date fixe, avec des publications majeures environ tous les 8 mois.

Après chaque publication principale, le responsable de publication publie un échéancier de la prochaine publication principale. Cet échéancier se trouve sur la page du wiki contenant la feuille de route du projet, par ex. https://code.djangoproject.com/wiki/Version6.0Roadmap.

### Feature release schedule and stages

#### Active development / Pre-feature freeze

Work begins on the feature release `A.B` after the feature freeze of the previous release, i.e. when the `stable/A.B-1.x` branch is forked.

Vous pouvez trouver la version de développement actuellement active dans le processus de publication de Django sur Trac.

#### Feature freeze / Alpha release

All major and minor features, including deprecations and breaking changes, must be merged by the feature freeze. Any features not done by this point will be deferred to the next feature release.

À partir de ce point, la branche `stable/A.B.x` divergera de la branche principale `main`.

#### Non-release blocking bug fix freeze / Beta release

After the alpha, all bug fixes merged in `main` are also backported to `stable/A.B.x`. Refactors are backported at the discretion of the merger. Mergers will be more and more conservative with backports, to avoid introducing regressions.

En parallèle à cette phase, `main` peut continuer de recevoir de nouvelles fonctionnalités en vue de leur publication dans le cycle `A.B+1`.

#### Gel des chaînes à traduire / version de prépublication

S’il y a toujours un flux conséquent de problèmes bloquants à la date prévue de prépublication, une seconde beta sera produite pour encourager davantage de tests et la date de prépublication sera reportée d’environ 1 mois.

La version de prépublication marque le gel des chaînes, et cela arrive au moins deux semaines avant la version finale. Les traducteurs peuvent alors soumettre les traductions mises à jour afin que celles-ci soient incluses dans la version finale. Après cette étape, aucune nouvelle chaîne à traduire ne doit être ajoutée.

Après la publication de la version candidate, seuls les bogues bloquants la publication et les corrections de documentation sont rétroportés.

#### Version finale

Idéalement, la version finale sera produite deux semaines après la publication de la dernière version candidate.

Si des bogues majeurs sont toujours présents 2 semaines après la publication de la version candidate, une décision devra être prise sur la manière de procéder (il est probable qu’une nouvelle version candidate soit produite et que la date de la version finale soit repoussée).

### Publications de correction de bogues

À la suite d’une publication majeure (par ex. A.B), la version précédente passe en mode correction de bogues.

The branch for the previous feature release (e.g. `stable/A.B-1.x`) will include bugfixes. Critical bugs fixed on main must also be fixed on the bugfix branch; this means that commits need to cleanly separate bug fixes from feature additions. The developer who commits a fix to main will be responsible for also applying the fix to the current bugfix branch.