Pregunta:
cómo nombrar tus proyectos
- nombre_proyecto-7.25-1.0-alpha
- nombre_proyecto-7.25-1.0-beta1
- nombre_proyecto-7.25-1.0-dev2
- nombre_proyecto-7.25-1.0-rc3
- nombre_proyecto-7.25-1.0-stable4
- nombre_proyecto-7.25-1.0-inestable5
siguiendo las mejores prácticas?
Respuesta:
Consulte Drupal.org para conocer las convenciones de nomenclatura de las versiones y más explicaciones .
Resumen:
rc = Release Candidate, considerado adecuado por el autor para los sitios de producción.
rc : Solo se debe crear una versión candidata cuando todos los problemas críticos de tipo de error se informan corregidos en la cola de problemas del proyecto. Esta etiqueta solo debe usarse cuando el desarrollador crea que el proyecto está listo para usarse en un sitio de producción. No existe una práctica recomendada oficial sobre el tiempo que un proyecto debe ser candidato a lanzamiento antes de crear un lanzamiento oficial .0, pero se sugiere que esté disponible durante al menos un mes con el estado establecido en "necesita revisión". Si algo (por ejemplo, se informa de un nuevo error crítico) hace que sea necesario crear una nueva versión durante este período, se debe crear una nueva versión candidata y debe permanecer durante al menos un mes con el estado establecido en "necesita revisión".
Está bien etiquetar un módulo como "rc" con problemas de solicitudes de funciones pendientes. Los autores de módulos no están obligados a cumplir con todas las solicitudes de función que los usuarios del módulo publican en la cola de problemas.
A continuación, se muestra una descripción de las otras etiquetas de lanzamiento permitidas:
inestable : el proyecto no se encuentra en un estado estable. Probablemente haya numerosos errores sin corregir, incluidos problemas de seguridad. La API puede cambiar sin previo aviso. El esquema de la base de datos puede cambiar sin que se implemente hook_update_N . Es posible que el uso y la API no estén documentados. Instalar una nueva versión inestable implica desinstalar el proyecto, perdiendo así todos los datos. Solo para aquellos que quieran una vista previa anticipada del proyecto. Aún no apto para desarrollo compartido.
alfa : la mayoría de los errores notificados se han resuelto, pero aún puede haber problemas conocidos pendientes graves, incluidos problemas de seguridad. El proyecto no se ha probado a fondo, por lo que también puede haber muchos errores desconocidos. Hay un README.txt / README.md que documenta el proyecto y su API (si corresponde). La API y el esquema de base de datos pueden ser utilizables, pero todos los cambios a estos se informan en las notas de la versión, y hook_update_N se implementa para preservar los datos a través de cambios de esquema, pero ninguna otra ruta de actualización / actualización. No apto para sitios de producción. El público objetivo son los desarrolladores que desean participar en las pruebas, la depuración y el desarrollo del proyecto.
beta : Se resuelven todos los errores críticos de seguridad y pérdida de datos. Si el módulo ofrece una API, debe considerarse congelado, de modo que aquellos que usan la API puedan comenzar a actualizar sus proyectos. Si se trata de una actualización o actualización de un proyecto, se debe ofrecer una ruta de actualización / actualización, y los usuarios existentes deben poder actualizar / actualizar a la nueva versión sin pérdida de datos. Toda la documentación debe estar actualizada. El público objetivo son los desarrolladores que desean participar en las pruebas, la depuración y el desarrollo del proyecto, y los desarrolladores de otros proyectos que interactúan con el proyecto. Generalmente no es adecuado para sitios de producción, pero puede usarse en algunos sitios de producción si el administrador del sitio conoce bien el proyecto y sabe cómo manejar los problemas restantes.
Las cadenas "dev" y "estable" no son válidas como parte de una etiqueta de lanzamiento, pero se supone que los lanzamientos de desarrollo sin etiquetar son "dev" y Drupal les proporciona descripciones como "7.x-1.x-dev" .org sistema de empaquetado de versiones para indicar que son versiones de desarrollo sin etiquetar.
Todas las etiquetas de lanzamiento deben terminar con un número. Los números son solo para distinguir entregas de la misma clase. El primero se numera "1" (como en "alpha1"), el siguiente "2", y así sucesivamente.
PD. Las cadenas que denotan lanzamientos (como "7.x-1.0-alpha4") se conocen como "etiquetas de lanzamiento" en el lenguaje de git, no como "nombres". Y nunca usa la versión menor de drupal como parte de una etiqueta, usa "x" en su lugar.