Quelles sont les meilleures pratiques pour la libération d'un projet open source? [fermé]

StackOverflow https://stackoverflow.com/questions/555982

Question

Nous avons un cadre peu web assez cool que nous avons utilisé avec succès sur des dizaines de projets clients. Nous prévoyons de libérer ce logiciel à la communauté. Cependant, je me tordant les mains sur ce qui devrait / doit-pas aller sur une nouvelle page de projet de logiciel open source. Quelles sont les choses que le site doit avoir? Docs? Un Wiki? Un lien pour télécharger? Quoi d'autre?

Et, une question connexe mais peut-être différente est de savoir comment commencer à marquer les numéros de version. Tout ce que nous utilisons est interne le timbre SVN. Y at-il un bon moyen de déterminer quand commencer à appeler la version quelque chose de 0,9 contre 1,0 et 1,1 et ainsi sur?

Était-ce utile?

La solution

Vous pouvez avoir une idée de ce qui est requis par ce projet open source sites d'hébergement offrent:

  • Un site Web qui fait office de « guichet unique » pour le projet
  • Docs, potentiellement sous forme de wiki
  • Un référentiel source permettant la navigation, la caisse anonyme et commits authentifiés et autorisés
  • Suivi d'émission et de nouvelles demandes de fonctionnalités

En ce qui concerne les numéros de version ... Je ne pense pas que tout le monde est a travaillé la meilleure façon de le faire encore :) Avec un minimum de pensée, je considère:

  • v1.0 devrait être prêt à l'emploi de la production
  • Les principaux changements de numéro de version peuvent perdre complètement rétrocompatibilité (si nécessaire - à peine un but bien)
  • changement de numéro de version mineure devrait normalement être la plupart du temps compatible - dévalorisant est probablement mieux que de supprimer / renommer les bits de l'API
  • numéro de version plus modeste que des changements mineurs ne devraient inclure des ajouts fonctionnels mineurs (le cas échéant) et bug / corrections de performance

Autres conseils

Le versioning, je pense que le meilleur endroit absolu à partir est sémantique Versioning .

0,9 / 1,0 / 1,1 / 1.0.1 / ... l'étiquetage version est à des fins de marketing uniquement (dans le bon sens de celui-ci). Cela permet à vos utilisateurs / clients d'identifier si le rejet est majeur, mineur ou bug-fix et si vous considérez mature ou pas encore.

Le minimum à fournir est des sources. D'autres produits livrables dépendent de la façon dont vous êtes prêt à aider vos utilisateurs et leur apporter un soutien.

Choisissez un site Web pour héberger la source sur la première (SourceForge, par exemple). Obtenez le haut source là sur un système de contrôle de version avec la caisse anonyme. Obtenez une adresse e-mail là-bas pour les gens de vous contacter.

Appelez cette première version 0.1. Ceci est parce que vous n'avez pas encore docs pour soutenir le projet.

Puis expirez.

Ensuite, commencer à regarder la documentation, comme un wiki. Une fois que vous avez tout couvert, à un niveau de base de détail, et vous croyez que la libération est prêt pour une heure de grande écoute, puis passer à 1,0, et commencer à fournir des téléchargements binaires.

Assurez-vous que vous pensez de la licence pour les sources.

Quand je regarde un projet open source, l'une des premières choses que je vérifie est la licence. Si la licence n'est pas GPL2 / GPL3 / styles BSD ou similaire, qui est un demotivator pour moi.

La licence signifie que les gens vont faire avec lui, comment il peut se développer, et combien il appartient à l'entreprise qui a libéré. Comme en choisissant open source que j'essaie de ne pas dépendre des sociétés (qui dépendent de leurs détenteurs d'actions), je choisis vraiment utiliser le logiciel qui est vraiment libre.

Alors que la communauté open source est très sensible au pouvoir des entreprises (Google semble un peu à l'abri qu'au moment), vous devez donc vraiment assurez-vous de transmettre le message de vraiment libre sur votre web site et d'autres matériaux que vous relâchiez sur le logiciel.

En savoir plus sur logiciel libre et définitions de source ouverte de la FSF.

Licencié sous: CC-BY-SA avec attribution
Non affilié à StackOverflow
scroll top