Cómo retirar una sección de contenido

Cuándo considerar retirar contenido

Puedes proponer retirar una sección del contenido de MDN Web Docs si se cumple alguna de estas condiciones:

• La tecnología está obsoleta o ya no es relevante para la plataforma web.
• La sección duplica información que se mantiene mejor en otro lugar (como el sitio de documentación oficial de un framework).
• La sección no está alineada con la estrategia de contenido de MDN.
• El costo de mantenimiento supera el valor para las personas que lo usan, según los datos de uso y los comentarios recibidos.

Retirar contenido siempre debe ser un proceso deliberado y visible. Las eliminaciones a gran escala nunca deben ocurrir sin discusión o aviso previo. La decisión final de retirar una sección corresponde al equipo de MDN.

El proceso de retiro

Retirar una sección del contenido de MDN Web Docs consta de dos fases: llegar a un acuerdo y luego eliminar el contenido.

Fase 1: Proceso de decisión

El retiro debe acordarse con el equipo de MDN y sus socios. La discusión puede ocurrir en nuestros canales de comunicación, mediante una discusión de GitHub o en nuestras llamadas editoriales (que se realizan cada dos semanas).

Si una sección se está considerando seriamente para retiro, debe abrirse una discusión de GitHub que registre la decisión y el proceso. La discusión debe dejar claro:

• El razonamiento detrás de la eliminación.
• El impacto de la eliminación.
• Que las partes interesadas relevantes están al tanto y han sido consultadas.
• Que se han considerado enfoques alternativos.

En algunos casos, la decisión también puede implicar recopilar comentarios de las personas que usan MDN. Esto puede incluir:

• Realizar una encuesta.
• Pedir comentarios mediante GitHub u otros canales de comunicación de MDN.

El objetivo es confirmar que la sección ya no satisface las necesidades de las personas que la usan y que no hay una vía clara para su mantenimiento sostenible.

Si se llega a un acuerdo para retirar una sección, debe fijarse un plazo, normalmente entre 3 y 6 meses. Las razones y el plazo deben registrarse en la discusión de GitHub. En la discusión debe quedar claro que el contenido se archivará, no se eliminará de forma permanente.

Si se decide no retirar la sección, esto debe comunicarse junto con las razones a través del canal de comunicación original.

Fase 2: Eliminar el contenido

Una vez que se ha llegado a un acuerdo, sigue estos pasos para eliminar el contenido.

Agregar un aviso de retiro

Agrega un banner de nota en la parte superior de cada artículo de la sección que se va a retirar. El aviso debe indicar claramente:

• Que la sección se va a eliminar del sitio web.
• El plazo y la fecha previstos para la eliminación.
• Que el contenido se archivará.
• Un enlace a la discusión de GitHub con más detalles.

Usa la siguiente plantilla:

> [!NOTE]
> Esta sección de MDN ya no recibe mantenimiento y se eliminará del sitio web en 6 meses (para MES AÑO). El contenido se archivará en el [MDN Museum](https://github.com/mdn/museum). Consulta [esta discusión](ENLACE) para más información.

Este aviso garantiza la transparencia y da tiempo a las personas para adaptarse.

Archivar y eliminar el contenido

Una vez transcurrido el periodo de retiro acordado, el contenido se puede eliminar de MDN Web Docs de la siguiente manera:

1. Archiva el contenido. Copia la sección al repositorio MDN Museum con fines de archivo. Mantén el contenido en un directorio que coincida con la ruta de la URL original. Por ejemplo, el contenido en https://developer.mozilla.org/es/docs/Games iría en un directorio /docs/games/ del repositorio del museo. Esto preserva el historial del contenido de MDN y a la vez mantiene el material obsoleto fuera del sitio activo.

2. Elimina el contenido y agrega redirecciones. Usa el comando delete para eliminar las páginas y configurar las redirecciones. Las redirecciones deben llevar a las personas al contenido alternativo más relevante, si existe. Si no hay una alternativa adecuada, redirige a la entrada correspondiente en la página de listado Contenido retirado (usando el ancla específica de la sección, por ejemplo, #nombre_de_la_seccion), para que quien llegue pueda encontrar contexto sobre lo que se eliminó y seguir el enlace a la versión archivada. Evita redirigir a la página de inicio de MDN Web Docs, ya que eso deja a quien lee sin ninguna explicación.

3. Limpia las referencias. Elimina o actualiza cualquier referencia a la sección retirada en todo MDN, incluidas las definiciones de barras laterales, las páginas de aterrizaje y los enlaces cruzados desde otros artículos. Agregar redirecciones (consulta el paso 2) evitará los enlaces rotos, pero la buena práctica es actualizar directamente el contenido que hace referencia.

4. Abre un issue para los cambios en la interfaz. Algunas partes de la interfaz del sitio web, como los menús de navegación y las secciones de la página de inicio, no forman parte del repositorio content, sino que las gestiona el equipo de plataforma. Abre un issue en el repositorio mdn/fred para verificar si se necesitan cambios en la interfaz que eliminen las referencias al contenido retirado. Si es así, coordina la eliminación del contenido y la actualización de la interfaz para que se despliegue al mismo tiempo.

Véase también

• Cómo crear, editar, mover o eliminar páginas
• Qué escribimos
• Experimental, obsoleto y en desuso
• Banners y avisos