Aller au contenu

Nouveautés produit et notes de version, sur un site à part

Vous livrez le produit, et c’est aussi vous qui expliquez ce qui a changé.

Gratuit pour commencer, sans carte. Vous pouvez exporter vos articles à tout moment, sur toutes les offres.

Une nouvelle version vient de sortir, et les utilisateurs qui suivent veulent savoir ce qui a changé. Une fiche dans un magasin d’applications n’a pas la place, un message sur un réseau sort du fil en un jour, et un journal des versions dans l’application ne touche que ceux qui l’ont déjà ouverte.

Les notes de version ont besoin d’une place sur le web ouvert : une adresse par version, retrouvée des mois plus tard par quelqu’un qui cherche la fonctionnalité, et un e-mail pour ceux qui en ont demandé un.

Typoza n’a pas de module de journal des versions. Il a des articles, des catégories, des mots-clés et une lettre d’information : de quoi faire un blog de notes de version.

Ce dont vous avez besoin

  • Une page par version, à une adresse qui dure

    Chaque article a sa propre adresse, fixée à sa première publication. Six mois plus tard, le lien glissé dans une réponse au support ouvre toujours la bonne version.

  • Un e-mail quand vous publiez

    Activez la Lettre, et publier un article l’envoie : chaque abonné le reçoit tout de suite ou dans un résumé quotidien ou hebdomadaire, au rythme qu’il a choisi. Une annonce qui n’est pas un article peut partir en message séparé, dans la limite quotidienne de votre offre.

  • Un éditeur qui sait montrer du code

    L’éditeur a des blocs de code avec un onglet par fichier, des fiches techniques pour ce qui a changé, et des encadrés en quatre tons pour les ruptures de compatibilité. Les raccourcis Markdown marchent à la frappe.

  • Des catégories qui trient le bruit

    Rangez les versions dans une catégorie, les articles de fond dans une autre, les incidents dans une troisième. Chaque catégorie a sa page, qu’un lecteur qui ne veut que les notes de version peut garder en favori.

  • Un site qui n’est pas votre produit

    Votre atelier tourne sur son propre sous-domaine, ou sur votre domaine avec une offre payante. Il ne partage aucun déploiement avec votre application, reste en ligne quand elle tombe, et publier un article ne demande aucune compilation.

Ce que Typoza ne fait pas

Mieux vaut le lire ici que le découvrir après trois articles écrits. Si l’un de ces points est bloquant pour vous, ne vous inscrivez pas.

  • Un lecteur ne peut pas suivre une seule catégorie. Les flux RSS, Atom et JSON et la Lettre portent tout ce que l’atelier publie.
  • Rien ne lit votre dépôt. Vous écrivez chaque note à la main : aucune étiquette, aucune plage de commits ni aucune pull request ne devient un article.
  • Pas de widget à placer dans votre application. Votre propre code peut lire le flux JSON et afficher les dernières notes.
  • Pas de page d’état. L’historique de disponibilité et les alertes d’astreinte relèvent d’un produit fait pour ça.
  • Aucun lien entre les commentaires et votre outil de suivi des bugs. Vos lecteurs peuvent répondre sous une note de version, et les rapports de bug passent toujours par l’outil que vous utilisez.
  • Pas de documentation versionnée. Un article fixe un moment ; une documentation avec une v1 et une v2 demande un outil de documentation.

L’article que vous remettez à plus tard

Écrivez-en le premier paragraphe aujourd’hui. L’article reste un brouillon tant que vous ne l’avez pas publié, et aucun lecteur ne le voit avant.

Gratuit pour commencer, sans carte. Vous pouvez exporter vos articles à tout moment, sur toutes les offres.

Les autres cas d’usage