You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: MAINTENANCE.md
+12-5Lines changed: 12 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ Directrices para los mantenedores de esta lista. Esta guía es común a todas la
8
8
9
9
El criterio fundamental es: **se acepta software que da soporte específico a Catalunya, no software hecho por alguien de Catalunya.**
10
10
11
-
Un repositorio se incluye porque interactúa con instituciones, servicios, infraestructura, normativas o datos propios de Catalunya. No basta con que el autor resida o trabaje aquí. Un framework genérico creado por un developer de Catalunya no pertenece a esta lista. Un cliente para la API de datos abiertos del gobierno de Catalunya o una integración con servicios públicos de Catalunya sí.
11
+
Un repositorio se incluye porque interactúa con instituciones, servicios, infraestructura, normativas o datos propios de Catalunya. No basta con que el autor sea de Catalunya o resida aquí. Un framework genérico creado por un developer de Catalunya no pertenece a esta lista. Un cliente para una API de servicios de Catalunya sí.
12
12
13
13
-**Sí:** Clientes de APIs de instituciones de Catalunya, integraciones con servicios públicos regionales, scrapers de transporte o datos abiertos de Catalunya.
14
14
-**No:** Librerías genéricas creadas por equipos de Catalunya, software genérico cuyo autor simplemente reside en la comunidad.
@@ -34,7 +34,7 @@ Ver `AGENTS.md` (si existe) para criterios detallados adicionales.
34
34
## Añadir entradas como mantenedor
35
35
36
36
1. Añadir la entrada simple en la sección correcta, en orden alfabético.
37
-
2. Ejecutar el pipeline de insignias (si el repo dispone de los scripts):
37
+
2. Ejecutar el pipeline de insignias (si existe):
38
38
```bash
39
39
bash scripts/gather-metadata.sh
40
40
python3 scripts/transform-readme.py
@@ -45,9 +45,15 @@ Ver `AGENTS.md` (si existe) para criterios detallados adicionales.
45
45
- Cuerpo: mensaje breve en español (tuteo) explicando la inclusión y ofreciendo retirarlo si lo prefiere.
46
46
-**Un solo issue por propietario** — nunca abrir múltiples issues en repos del mismo usuario/organización.
47
47
48
-
## Eliminar entradas
48
+
## Eliminar entradas y DELETED.md
49
49
50
-
Las entradas no se borran sin más. Se mueven a `DELETED.md` en la sección correspondiente:
50
+
Cada repositorio tiene (o debe tener) un fichero `DELETED.md`. Es una pieza fundamental del mantenimiento: registra todos los proyectos que estuvieron en la lista y fueron retirados, junto con el motivo. Su propósito es:
51
+
52
+
-**Evitar re-adiciones:** si alguien propone un proyecto ya retirado, se puede consultar por qué se eliminó.
53
+
-**Preservar el historial:** deja constancia de decisiones pasadas para futuros mantenedores.
54
+
-**Documentar razones:** cada entrada lleva contexto suficiente para entender la retirada.
55
+
56
+
Las entradas nunca se borran sin más del README. Se mueven a `DELETED.md` en la sección correspondiente:
51
57
52
58
| Razón | Sección en DELETED.md |
53
59
|-------|-----------------------|
@@ -57,7 +63,7 @@ Las entradas no se borran sin más. Se mueven a `DELETED.md` en la sección corr
57
63
| No cumple criterios de inclusión | Eliminados por no ser específicos de Catalunya |
58
64
| Sustituido por otro proyecto | Reemplazados (enlazar sucesor) |
59
65
60
-
Esto evita re-adiciones y preserva el historial.
66
+
Si el repo aún no tiene `DELETED.md`, crearlo con las secciones anteriores la primera vez que se retire un proyecto.
61
67
62
68
## Mantenimiento periódico
63
69
@@ -70,6 +76,7 @@ Esto evita re-adiciones y preserva el historial.
0 commit comments