Skip to content

Commit a74cff6

Browse files
committed
docs: expand MAINTENANCE.md with DELETED.md guidance and proper accents
1 parent e5641cf commit a74cff6

1 file changed

Lines changed: 12 additions & 5 deletions

File tree

MAINTENANCE.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Directrices para los mantenedores de esta lista. Esta guía es común a todas la
88

99
El criterio fundamental es: **se acepta software que da soporte específico a Catalunya, no software hecho por alguien de Catalunya.**
1010

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í.
1212

1313
- **Sí:** Clientes de APIs de instituciones de Catalunya, integraciones con servicios públicos regionales, scrapers de transporte o datos abiertos de Catalunya.
1414
- **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.
3434
## Añadir entradas como mantenedor
3535

3636
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):
3838
```bash
3939
bash scripts/gather-metadata.sh
4040
python3 scripts/transform-readme.py
@@ -45,9 +45,15 @@ Ver `AGENTS.md` (si existe) para criterios detallados adicionales.
4545
- Cuerpo: mensaje breve en español (tuteo) explicando la inclusión y ofreciendo retirarlo si lo prefiere.
4646
- **Un solo issue por propietario** — nunca abrir múltiples issues en repos del mismo usuario/organización.
4747

48-
## Eliminar entradas
48+
## Eliminar entradas y DELETED.md
4949

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:
5157

5258
| Razón | Sección en DELETED.md |
5359
|-------|-----------------------|
@@ -57,7 +63,7 @@ Las entradas no se borran sin más. Se mueven a `DELETED.md` en la sección corr
5763
| No cumple criterios de inclusión | Eliminados por no ser específicos de Catalunya |
5864
| Sustituido por otro proyecto | Reemplazados (enlazar sucesor) |
5965

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.
6167

6268
## Mantenimiento periódico
6369

@@ -70,6 +76,7 @@ Esto evita re-adiciones y preserva el historial.
7076
[ "$archived" = "true" ] && echo "ARCHIVADO: $repo"
7177
done
7278
```
79+
Mover los archivados a `DELETED.md`.
7380

7481
## Herramientas
7582

0 commit comments

Comments
 (0)