En primer lugar, gracias por contribuir al ecosistema de Bazel. Comunícate con la comunidad de Bazel en la lista de distribución de bazel-discuss para compartir tu proyecto y el nombre sugerido.
Si estás creando una herramienta relacionada con Bazel o compartiendo tus reglas de Skylark, te recomendamos que sigas estos lineamientos para el nombre de tu proyecto:
Cómo asignar nombres a las reglas de Starlark
Consulta Cómo implementar reglas nuevas de Starlark en la documentación.
Nombres de otras herramientas relacionadas con Bazel
Esta sección se aplica si compilas una herramienta para enriquecer el ecosistema de Bazel. Por ejemplo, un nuevo complemento para IDE o un nuevo migrador de sistema de compilación.
Elegir un buen nombre para tu herramienta puede ser difícil. Si no tenemos cuidado y usamos demasiados nombres internos, el ecosistema de Bazel podría volverse muy difícil de comprender para los recién llegados.
Sigue estos lineamientos para asignar nombres a las herramientas de Bazel:
Preferimos no presentar un nombre de marca nuevo: "Bazel" ya es una marca nueva para nuestros usuarios, por lo que debemos evitar confundirlos con demasiados nombres nuevos.
Prefiere usar un nombre que incluya "Bazel": Esto ayuda a expresar que es una herramienta relacionada con Bazel y también ayuda a las personas a encontrarla con un motor de búsqueda.
Prefiere usar nombres que describan lo que hace la herramienta: Idealmente, el nombre no debería necesitar un subtítulo para que los usuarios puedan adivinar qué hace la herramienta. Usar palabras en inglés separadas por espacios es una buena forma de lograrlo.
No es necesario usar un tema floral o de comida: Bazel evoca la planta albahaca. No es necesario que busques un nombre que sea una planta, un alimento o que se relacione con "albahaca".
Si tu herramienta se relaciona con otra marca de terceros, úsala solo como descriptor: Por ejemplo, usa "Migrador de Bazel para Cmake" en lugar de "Migrador de Cmake Bazel".
Estos lineamientos también se aplican a la URL del repositorio de GitHub. Leer la URL del repositorio debería ayudar a las personas a comprender qué hace la herramienta. Por supuesto, el nombre del repositorio puede ser más corto y debe usar guiones en lugar de espacios y letras minúsculas.
Ejemplos de buenos nombres:
- Bazel for Eclipse: Los usuarios comprenderán que, si desean usar Bazel con Eclipse, este es el lugar donde deben buscar. Utiliza una marca de terceros como descriptor.
- Granja de compilación de Bazel: Una "granja de compilación" es una granja de compilación. Los usuarios comprenderán que este proyecto se relaciona con la creación de servidores.
Ejemplos de nombres que debes evitar:
- Ocimum: El nombre científico de la albahaca no se relaciona lo suficiente con el proyecto de Bazel.
- Bazelizer: La herramienta detrás de este nombre podría hacer muchas cosas, por lo que el nombre no es lo suficientemente descriptivo.
Ten en cuenta que estas recomendaciones se alinean con los lineamientos que Google usa cuando lanza un proyecto de código abierto.