Skip to Content

Changelog

Rédigez des notes de version par projet et publiez-les sur votre portail.

Le changelog peut être désactivé par projet — voir Réglages du projet.

  • Cycle de vie : les entrées sont brouillon → planifiée → publiée. Seules les entrées publiées apparaissent sur le portail (et dans son flux RSS).
  • Versions : les entrées portent une version de type semver (ex. 1.4.0).
  • Labels : taguez les entrées (ex. Nouveau, Amélioré, Corrigé).
  • Traductions : les entrées peuvent être traduites automatiquement dans les autres langues de votre projet.
  • Annonces par e-mail : les entrées publiées peuvent être envoyées par e-mail aux abonnés ; le volume mensuel dépend de la formule (Pro : 5 000, Team : 25 000). Pro

Créer une entrée de changelog

  1. Cliquez sur Nouvelle entrée dans la page Changelog du projet
  2. Entrez un titre (requis) et corps (optionnel, Markdown supporté)
  3. Définissez la version (ex. 1.4.0) — doit être unique par projet
  4. Ajoutez des étiquettes (Nouveau, Amélioré, Corrigé) pour les catégoriser
  5. Choisissez état:
    • Brouillon — sauvegardé localement, non visible pour les utilisateurs
    • Planifié — sera publié à une date/heure future
    • Publié — visible sur le portail et dans le flux RSS

Workflow de brouillons

  • Les brouillons ne sont visibles que pour les membres de l’équipe
  • Modifiez les brouillons à tout moment avant publication
  • Utilisez les brouillons pour préparer les notes de version à l’avance

Traductions

  • Les entrées de changelog peuvent être autorisées dans plusieurs langues
  • Lorsqu’un visiteur a son langue, il voit la version traduite
  • Les traductions automatiques peuvent être acceptées ou rejetées

Publication

  • Les entrées publiées apparaissent sur votre portail et dans le flux RSS
  • La date/heure published_at est définie automatiquement

Audience

Chaque entrée du changelog cible une audience :

  • Tous les utilisateurs (par défaut) — publique : affichée sur le portail, incluse dans le flux RSS et l’API publique, et (à la publication) envoyée par e-mail à vos abonnés au changelog et aux votants des publications liées.
  • Testeurs bêta uniquement — privée, réservée à un programme bêta que vous choisissez. L’entrée n’est affichée sur le portail qu’aux testeurs vérifiés et inscrits de ce programme, est exclue du flux RSS et de l’API publique, et (à la publication) envoie des e-mails aux testeurs de ce programme plutôt qu’à l’audience générale.

Choisissez Testeurs bêta uniquement et sélectionnez le programme lors de la création ou de la modification de l’entrée. Vous devez d’abord disposer d’au moins un programme bêta sur le projet (voir Tests bêta). Pour ouvrir plus tard une entrée bêta à tous, modifiez-la et passez l’audience à Tous les utilisateurs : elle devient alors visible publiquement. (Une entrée n’envoie un e-mail qu’une seule fois, à sa première publication ; l’ouvrir ne renvoie pas l’annonce.)

Last updated on