¿Cuáles son las mejores prácticas para el lanzamiento de un proyecto de código abierto? [cerrado]

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

Pregunta

Tenemos un marco poco web muy bueno que hemos utilizado con éxito en decenas de proyectos de los clientes. Estamos pensando en liberar este software para la comunidad. Sin embargo, estoy retorciendo mis manos sobre lo que debe / debería, no ir a una nueva página de proyectos de software de código abierto. ¿Cuáles son las cosas que el sitio debe tener? Docs? Un Wiki? Un enlace para descargar? ¿Qué más?

Y, una pregunta relacionada pero diferente, posiblemente, es ¿cómo empezamos marcando los números de la versión. Todos usamos internamente es el sello de subversion. ¿Hay una buena manera de determinar cuándo empezar a llamar a algo versión 0.9 frente a 1.0 y 1.1 y así-en?

¿Fue útil?

Solución

Puede hacerse una idea de lo que se requiere por lo que los sitios de alojamiento de proyectos de código abierto proporcionan:

  • Un sitio web que actúa como la "ventanilla única" para el proyecto
  • Docs, posiblemente en forma de wiki
  • Un repositorio de código fuente que permite la navegación, pago y envío anónimo, y se compromete autenticados y autorizados
  • seguimiento de problemas y nueva característica peticiones

En cuanto a los números de versión ... no creo es cualquier funcionó la mejor forma de hacer que aún :) Con un mínimo de pensamiento, me gustaría considerar:

  • v1.0 debería estar listo para su uso en producción
  • Los principales cambios de número de versión pueden perder por completo la compatibilidad hacia atrás (si es necesario - apenas un gol aunque)
  • cambios de número de versión secundaria debe ser por lo general en su mayoría compatibles - desaprobación es probablemente mejor que la eliminación / cambio de nombre de bits de la API
  • cambios de número de versión más pequeña de lo menor sólo deben incluir adiciones menores funcionales (si lo hay) y de errores / correcciones de rendimiento

Otros consejos

En versiones, creo que el mejor sitio para empezar es de semántica de versiones .

El 0.9 / 1.0 / 1.1 / 1.0.1 / ... Versión etiquetado es para propósitos de marketing única (en el buen sentido de la misma). Esto permite a sus usuarios / clientes para identificar si la liberación es mayor, menor o de corrección de errores y si se tiene en cuenta que madura o todavía no.

El mínimo es de entregar fuentes. Otras prestaciones dependen de la forma en que está dispuesto a ayudar a los usuarios y les proporcionará apoyo.

Elegir un sitio web para alojar la fuente de primera (SourceForge, por ejemplo). Obtener la fuente hasta allí en un sistema de control de versiones con la caja anónima. Obtener una dirección de correo electrónico de la existencia de las personas en contacto con usted.

Llama a esta primera versión 0.1. Esto se debe a que no tiene documentos aún para apoyar el proyecto.

A continuación, respirar.

A continuación, empezar a buscar en la documentación, como un wiki. Una vez que tenga todo cubierto, en un nivel básico de detalle, y cree que la liberación está listo para algunos horario estelar, a continuación, pasar a 1,0, y empezar a ofrecer descargas binarios.

Asegúrese de que usted piensa acerca de la licencia de las fuentes.

Cuando miro a un proyecto de código abierto, una de las primeras cosas que comprobar es la licencia. Si la licencia no es GPL2 / GPL3 / BSD estilos o similares, eso es un desmotivador para mí.

La licencia significa lo que la gente va a hacer con él, cómo se puede crecer, y lo mucho que es propiedad del corporativo que soltó. Como por la elección de código abierto Trato de no depender de las corporaciones (que dependen de sus accionistas), realmente decide utilizar el software que es realmente libre.

A medida que la comunidad de código abierto es muy sensible al poder de las empresas (Google parece un poco inmune a que por el momento), por lo que realmente debe asegurarse de entregar el mensaje de verdaderamente libre en tu web sitio y otros materiales se suelta sobre el software.

Vea más en software libre y definiciones de código abierto de la FSF.

Tome un vistazo a GitHub o Google Code. que proporcionan un muy buen punto de partida para propios proyectos de código abierto. Se puede describir su proyecto, documentate en un wiki, usar git svn o como su repositorio, y proporcionar descargas junto con un seguimiento de problemas y gestión multi-desarrollo. Agradables ambientes fuera de la caja para aprender de y para los utilizan.

Para obtener los números de liberación: No recomiendo 0,9 o algo similar para pre-versiones. ¿La razón? ¿Qué pasa con la liberación 1.9? ¿Es el noveno sub-lanzamiento de la versión principal 1 o se trata de la última versión preliminar de la liberación de 2? Mi nivel de liberación es lo describen aquí: http://code.google.com/p / tideland-EAS / wiki / ReleaseStandard . Estoy usando un número de tres-esquema, mayor, menor, y fijar, junto con un código de estado, alfa, beta, gamma y la fecha de lanzamiento. Así que soy capaz de manejar varias versiones en paralelo con facilidad.

Espero que esto ayude.

mue

Licenciado bajo: CC-BY-SA con atribución
No afiliado a StackOverflow
scroll top