Convención de Nombres de Repositorios GitLab
Regla general
| Campo en GitLab | Convención | Ejemplo |
|---|---|---|
| Project name (nombre visible en UI) | Title Case con espacios | Wiedii Configs |
| Project path (URL / slug) | kebab-case | wiedii-configs |
La URL completa resultante sería:
https://gitlab.wiedii.co/wildcat/wiedii-configs
git@gitlab.wiedii.co:wildcat/wiedii-configs.git
Por qué esta convención
- Title Case con espacios en el nombre → legibilidad en la UI de GitLab, en notificaciones y en MRs
- kebab-case en el path → URLs limpias, estándar universal para paths de repositorios git
Tabla de repos actuales y su nombre canónico
| Project path | Project name canónico | Estado |
|---|---|---|
wiedii-configs | Wiedii Configs | ✅ renombrado |
renovate-runner | Renovate Runner | pendiente renombrar |
wdev | Wdev | pendiente renombrar |
homebrew-wiedii-tools | Homebrew Wiedii Tools | pendiente renombrar |
Excepciones — paths con restricciones externas
homebrew-wiedii-tools — restricción de Homebrew
El path debe mantener el prefijo homebrew- en kebab-case. Es un requisito de protocolo del gestor Homebrew: al hacer brew tap wiedii/tools, Homebrew construye la URL añadiendo automáticamente el prefijo homebrew- al nombre del tap.
El nombre visible sí puede ser Homebrew Wiedii Tools.
renovate-runner — referencias en configs de todos los repos
El path aparece en el renovate.json de todos los repositorios Wiedii:
{
"extends": ["local>wildcat/renovate-runner//.gitlab/renovate.json"]
}
Renombrar el path requeriría actualizar renovate.json en todos los repos. El path no cambia — solo el nombre visible.
Cómo cambiar el nombre visible de un repo en GitLab
Solo cambia el Project name — el path (URL) no se modifica:
- Ir a Settings → General → Naming, topics, avatar
- Cambiar Project name al formato Title Case con espacios
- Dejar Project path sin cambios
- Hacer clic en Save changes
No se requiere actualizar remotes locales ni referencias en archivos — el path no cambia.
Nuevos repositorios
Al crear un repo nuevo, establecer desde el inicio:
- Project name:
Mi Nuevo Proyecto(Title Case con espacios) - Project path:
mi-nuevo-proyecto(kebab-case — GitLab lo pre-rellena así automáticamente)
Carpeta local del proyecto
La carpeta local del repo (bajo ~/Docker/, regla #4 de politicas-core) se llama igual que el Project path — kebab-case, idéntico al slug del repositorio. Nada de espacios, Title Case ni nombres inventados.
# ✅ la carpeta = el path del repo
git clone git@gitlab.wiedii.co:wildcat/wiedii-configs.git ~/Docker/wiedii-configs
# ❌ no renombrar la carpeta
git clone … ~/Docker/"Wiedii Configs" # espacios / Title Case
git clone … ~/Docker/configs # nombre distinto al slug
git clone ya crea la carpeta con el nombre del repo si no se pasa destino — basta con no sobreescribirlo. Que carpeta = path hace predecible la ubicación (~/Docker/<slug>), evita ambigüedad entre proyectos y mantiene una sola nomenclatura entre Git, la URL y el disco.
Grupos y namespaces
La convención aplica solo al project name y path. Los grupos/namespaces siguen su convención actual (ej. wildcat permanece en minúsculas).
Referencias
- repo-setup — checklist completo de setup de un nuevo repositorio
- politicas-core — políticas generales de desarrollo