Politique de publication
Comment PyColors envoie les mises à jour à travers l'écosystème. Versions prévisibles, versioning clair et progrès transparents.
Comment les navires PyColorsLien vers la section
PyColors est conçu pour se déplacer rapidement Sans devenir instable.
Le modèle de publication sépare deux choses qui se mélangent souvent :
- packages Versioning technique
- écosystème à la progression du produit
Cette séparation permet à PyColors de publier des mises à jour de paquets précises tout en communiquant la progression du produit de manière à ce que les clients et les développeurs puissent comprendre.
Idée de base
Les paquets suivent la vérité technique. L’écosystème communique l’élan produit.
Modèle de publicationLien vers la section
Paquets
Écosystème
Versioning des paquetsLien vers la section
Paquets publics tels que @pycolors/ui, @pycolors/tokens, et les paquets de configuration partagés suivent Versioning sémantique.
MAJOR → breaking changes
MINOR → new features, backward compatible
PATCH → fixes and small improvementsExemples :
1.0.3 → bug fixes
1.1.0 → new components or backward-compatible features
2.0.0 → breaking changespublication des correctifs
Use for bug fixes, documentation fixes, small polish, dependency-safe maintenance, and internal improvements that do not change the public API.
Source de véritéLien vers la section
Les informations de publication sont divisées par audience et par objectif.
| Surface | Objet |
|---|---|
| GitHub | Détails de la version technique |
CHANGELOG.md | Modifications au niveau des packages générées par Changesets |
/changelog | Mises à jour hebdomadaires de l'écosystème |
/roadmap | Direction des produits et travaux à venir |
Pourquoi ce split
Les développeurs ont besoin de changements techniques précis. Les clients ont besoin d'une progression claire du produit. PyColors garde les deux visibles sans les mélanger.
Ecosystem ReleasesLien vers la section
Le site Web communique une cadence de diffusion hebdomadaire.
Cela inclut les mises à jour dans :
- PyColors UI
- Tokens PyColors
- Starter Free
- Starter Pro
- modèles
- documentation
- patrons
- pages marketing
- plate-forme et couches de livraison
Les colis sont expédiés quand ils sont prêts.
L'écosystème est livré comme un récit de produit clair.
La vérité technique reste précise. Le progrès du produit reste compréhensible.
Flux de travail ChangesetsLien vers la section
Toutes les versions des paquets suivent le même modèle opérationnel.
Apporter des changements dans le monorepoLien vers la section
Le développement se produit dans le noyau PyColors monorepo où les packages, les applications, les modèles, les documents et la configuration partagée évoluent ensemble.
Ajouter un changesetLien vers la section
Chaque modification au niveau du paquet obtient un jeu de modifications avec le type de version correct : patch, mineur ou majeur.
Fusionner à mainLien vers la section
Les modifications sont examinées et fusionnées via le flux de travail normal du référentiel.
Version et changelog sont mis à jourLien vers la section
CI met à jour les versions des paquets et génère des entrées de journal des modifications au niveau des paquets.
Publier et publierLien vers la section
CI publie des paquets et crée des versions GitHub le cas échéant.
Non négociablesLien vers la section
Ces règles maintiennent les libérations prévisibles.
Garder les libérations de paquets précises
- développement se produit dans le noyau monorepo
- Les dépôts publics sont des surfaces de distribution
- Les paquets publics utilisent Changesets
- Les changements nécessitent des versions majeures
- GitHub Releases reste une vérité technique
Gardez les progrès de l'écosystème lisibles
- le site web reflète la progression du produit
- Des communiqués hebdomadaires expliquent le mouvement de l'écosystème
- Les entrées du changelog restent lisibles
- Les mises à jour de le panneau latéral de route restent transparentes
- Les secrets internes et les détails CI ne sont pas exposés
Pourquoi cette approcheLien vers la section
La plupart des projets tombent dans l'un des deux problèmes de publication:
- les rejets sont trop lents, donc le produit se sent inactif
- Les versions sont trop chaotiques, donc les utilisateurs perdent confiance
PyColors équilibre les deux:
- itération technique rapide au niveau du paquet
- Une communication prévisible au niveau de l’écosystème
Cela crée un rythme de publication qui soutient à la fois la confiance des développeurs et la confiance commerciale.
Ce que cela garantitLien vers la section
Cette politique est conçue pour fournir :
- Mises à jour prévisibles
- versioning clair
- Pas de changements de rupture cachés
- Progrès visibles du produit
- Historique des paquets traçables
- séparation entre la vérité technique et la narration du produit
Principe de confiance
Un produit de développeur premium ne devrait pas seulement être livré fréquemment. Cela devrait rendre les progrès faciles à comprendre.
Public vs interneLien vers la section
Le modèle de publication est public à dessein.
Informations de publication visibles
- versions des paquets
- Entrées changelog
- GitHub
- feuille de route progrès
- Mises à jour hebdomadaires de l'écosystème
Détails opérationnels privés
- CI secrets
- identifiants de déploiement
- Infrastructures internes
- workflows opérationnels privés
Modèle mentalLien vers la section
Les paquets bougent avec une précision technique. L’écosystème évolue avec la clarté du produit.