tag - ¿Hay una convención de nomenclatura para los repositorios de git?

tipos de etiquetas en git

Question

Por ejemplo, tengo un servicio RESTful llamado Servicio de Compra. Debo nombrar mi repositorio

1. purchaserestservice
2. purchase-rest-service
3. purchase_rest_service
4. ¿o algo mas?

¿Qué es la convención? ¿Qué tal en github? ¿Deben los repositorios públicos seguir algún estándar?

Answer 1

El problema con el caso camel es que a menudo hay diferentes interpretaciones de las palabras, por ejemplo, checkinService vs checkInService. De acuerdo con la respuesta de Aaron, es difícil que se complete automáticamente si tiene muchos repositorios con nombres similares para tener que verificar constantemente si la persona que creó el repositorio que le interesa utilizó un cierto desglose de las mayúsculas y minúsculas. evitar mayúsculas

Su punto sobre los guiones también es bien aconsejado.

1. use minúsculas
2. utilizar guiones.
3. se específico. es posible que tenga que diferenciar ideas similares más adelante, es decir, utilice la compra-servicio-descanso en lugar del servicio o el servicio-resto.
4. se consistente. considere el uso de los diversos proveedores de GIT: ¿cómo desea que se clasifiquen / agrupen sus repositorios?

Answer 2

Sin favorecer ninguna opción de nombre en particular, recuerde que un repositorio de git se puede clonar en cualquier directorio raíz de su elección:

git clone https://github.com/user/repo.git myDir

Aquí repo.git se repo.git en el directorio myDir .

Entonces, incluso si su convención de nomenclatura para un repositorio público terminó siendo ligeramente incorrecta, todavía sería posible solucionarlo en el lado del cliente.

Es por eso que, en un entorno distribuido donde cualquier cliente puede hacer lo que quiera, realmente no existe una convención de nombres para el repositorio de Git.
(excepto para reservar " xxx.git " para la forma desnuda del repositorio '' xxx '')
Puede haber una convención de denominación para el servicio REST (similar a " ¿Hay alguna guía de convención de denominación para las API REST? "), Pero ese es un problema aparte.

Answer 3

Tal vez es solo mi fondo de Java y C, pero prefiero CamelCase (CapCase) sobre la puntuación en el nombre. Mi grupo de trabajo utiliza dichos nombres, probablemente para coincidir con los nombres de la aplicación o el servicio que contiene el repositorio.

Answer 4

Yo iría para la purchase-rest-service . Razones:

1. ¿Qué es "pur chase rests ervice"? Las palabras largas y concatenadas son difíciles de entender. Lo sé, soy alemán. "Donaudampfschifffahrtskapitänspatentausfüllungsassistentenausschreibungsstellenbewerbung".

2. "_" es más difícil de escribir que "-"

Answer 5

lowercase-with-hyphens son el estilo que veo con más frecuencia en GitHub. *

lowercase_with_underscores es probablemente el segundo estilo más popular que veo.

El primero es mi preferencia porque guarda las pulsaciones.

^{* Anecdótico; No he recogido ningún dato.}