La refactorización es un proceso de redacción en el que el contenido de la página de discusión se mueve, elimina, revisa, reestructura, oculta o cambia de alguna otra forma. Se aplica únicamente en contextos en los que los editores realizan declaraciones firmadas (como en los espacios de nombres de discusión y discusión del usuario ).
La refactorización tiene varios usos, entre ellos:
La refactorización es más asertiva que la edición de copia , pero menos sustancial que el archivo . Al igual que la edición de copia, siempre conserva el significado y la intención del editor original. Al igual que el archivo, puede ocultar material de la visibilidad inmediata. Debe usarse como una herramienta para separar material innecesario de una discusión sobre la marcha , sin esperar al archivo formal de toda la discusión.
El término "refactorización" es una adaptación de la refactorización de código en informática , donde el código se reestructura (para mejorar su calidad) de una manera que no cambia el funcionamiento del programa.
Las buenas prácticas de refactorización son una parte importante del mantenimiento de una página de discusión productiva. Las páginas de discusión que son confusas, hostiles, demasiado complejas, mal estructuradas o congestionadas con comentarios cruzados pueden desanimar a los posibles colaboradores y generar malentendidos que socaven las discusiones fructíferas.
La refactorización solo se debe realizar cuando se asume que los editores que han contribuido a la página de discusión han actuado de buena fe . Si recientemente hubo discusiones acaloradas en la página de discusión, es posible que falte buena fe. Si otro editor objeta alguna refactorización realizada, esos cambios deben revertirse. Sin embargo, si la página es más grande que el tamaño recomendado, aún se puede archivar la página de discusión, o secciones dentro de ella, sin refactorizar.
En los primeros tiempos de la historia de Wikipedia, y particularmente antes de 2006, el contenido de las páginas de discusión se resumía para ahorrar espacio, un método de refactorización no conservador. Sin embargo, la comunidad ha llegado a preferir el archivo general de las discusiones de las páginas de discusión, ya que el archivo preserva un registro más completo de las discusiones, no conduce a la tergiversación (accidental o disruptiva) de las opiniones de otros editores y conserva material que puede ser útil en el futuro. El mismo principio se ha llegado a aplicar a la refactorización de manera más amplia.
Como regla general, los editores no deberían editar los comentarios de los demás de manera que afecten el significado (al hacerlo se crean tergiversaciones, se interrumpe el flujo de las conversaciones y se hace imposible seguir los debates y las discusiones), pero existen casos en los que los comentarios de un editor deben eliminarse del flujo de la conversación porque los comentarios mismos interrumpen el flujo de la conversación. En términos generales, los siguientes tipos de refactorización son legítimos, con las advertencias enumeradas:
Limpieza no contenciosa : cualquier cosa en la que estés seguro de que el otro editor te agradecerá el esfuerzo, en lugar de enojarse.
Reestructuración : debe realizarse con cuidado para evitar cambiar significados.
Poda de texto : solo debe realizarse con el consentimiento del autor original o por una buena causa según la política.
Siguiendo las pautas de la página de discusión de Wikipedia , se recomienda a los editores que eliminen cualquier contenido que no sea apropiado. Se debe agregar un enlace al historial de la página de discusión si el texto eliminado fue parte de discusiones de otros editores. Consulte WP:Diff para obtener instrucciones sobre cómo crear un enlace al historial de la página y WP:Pautas de la página de discusión#Comportamiento inaceptable para obtener instrucciones sobre contenido inapropiado en la página de discusión.
Hay varias herramientas y técnicas disponibles para refactorizar material:
<s>text to be struck</s>produce {{rf}}La herramienta o técnica a utilizar debe elegirse según las necesidades particulares del material.
Se recomienda la creación de una sección de preguntas frecuentes para todos los puntos que probablemente se planteen y refactoricen repetidamente. El material existente debe generalizarse adecuadamente y reformatearse en un formato simple de preguntas y respuestas para que los editores posteriores puedan resolver sus inquietudes sin plantear la pregunta nuevamente. Asimismo, las discusiones prolongadas y continuas pueden beneficiarse de la refactorización de la plantilla con un resumen. La plantilla {{ quote box }} se puede utilizar para proporcionar un cuadro de resumen flotante junto a una discusión refactorizada, o se puede agregar un comentario en la parte inferior (o, a veces, en la parte superior) de una sección.
En algunos casos, es conveniente dividir el debate en nuevas secciones o subsecciones. Esto resulta útil cuando una sección se vuelve demasiado larga o cuando la conversación comienza a divergir hacia varios puntos separados. La división en secciones puede ayudar tanto a los lectores como a los participantes a comprender el flujo del debate y a encontrar partes relevantes del texto.
En los debates largos, los participantes suelen insertar saltos arbitrarios añadiendo un nuevo título de subsección. De hecho, a estos saltos se les suele dar títulos como "Salto arbitrario" o "Salto de conveniencia", con un número de índice para distinguirlos de otros títulos de saltos arbitrarios. En cambio, los debates que cubren varios puntos o se vuelven más complejos pueden beneficiarse de la creación de subsecciones para abordar diferentes puntos o, en casos extremos, de la división de secciones de texto en secciones completamente nuevas. En estos casos puede ser necesario reorganizar grandes fragmentos de texto y, en ese caso, se debe tener cuidado de garantizar que ningún comentario se saque de contexto o pierda la conexión con el punto original que abordaba. Puede ser aconsejable copiar secciones de texto en lugar de moverlas (añadiendo un comentario que remita al texto original), duplicar la firma del autor original en diferentes puntos que se han movido a diferentes secciones o comenzar la nueva sección con una declaración entre paréntesis que explique el contexto original del comentario.
Vea los ejemplos a continuación.
Estas preocupaciones deben tenerse en cuenta al refactorizar:
Tenga en cuenta que no todos los editores estarán de acuerdo con su refactorización o incluso con el concepto de refactorización en general. Proporcione enlaces a la versión original, sin cortes, para que otros puedan verificar sus cambios y, si es necesario, volver al original para aclarar lo que dijo realmente un autor. Esta combinación de refactorización y archivo a menudo evitará quejas de que se perdió información. Deje explícito que ha refactorizado algo para que nadie se confunda y piense que esta era la página de discusión original.
Si cree que la gente puede oponerse a que se refactorice su discusión, haga su resumen en una página diferente. En lugar de reducir los archivos 7 a 10 de Discusión:Nuevo Imperialismo , cree una nueva página titulada [[Discusión:Nuevo Imperialismo/Resumen de los archivos 7 a 10]]. Enlace esta página al principio de los archivos correspondientes y a la página de discusión actual. Esto les da a los recién llegados la oportunidad de obtener una comprensión rápida sin el riesgo de perder lo que se ha dicho antes. Tener un archivo vinculado puede ayudar a satisfacer tanto a aquellos que sienten que sus palabras deben permanecer intactas como a aquellos que quieren un resumen ordenado.
Una refactorización simple se puede hacer fácilmente con la edición estándar del navegador de Wikipedia, pero si se enfrenta a un trabajo de refactorización particularmente complejo o tedioso, un editor de texto avanzado o cualquiera de una variedad de lenguajes de programación pueden ser inmensamente útiles. Básicamente, cualquier herramienta que tenga funciones extendidas de búsqueda y reemplazo, capacidades de expresión regular o procesamiento de texto programático se convertirá en su mejor amigo. Ordenar alfabéticamente el material, ordenar las secciones en orden cronológico, cambiar múltiples enlaces, reestructurar tablas grandes: estas tareas pueden ser tediosas y consumir mucho tiempo si se hacen a mano, pero se pueden lograr en cuestión de minutos mediante programación. La mayoría de los editores de texto de alta gama de tipo "Office" tienen capacidades avanzadas de edición de texto y hay disponibles muchas aplicaciones de edición de texto ligeras pero potentes; consulte la lista de editores de texto . También existen muchos lenguajes de programación para el procesamiento de texto; los más comunes son Perl , Python , Unix shell scripting y AppleScript .
Para trabajos de refactorización largos, puede resultar útil etiquetar las páginas que se están refactorizando con Template:In use . Simplemente agréguelo {{in use}}en la parte superior de las páginas. Esto alertará a otros editores sobre el hecho de que las páginas están en construcción y debería ayudar a minimizar los conflictos de edición .
Páginas de discusión o secciones de páginas de discusión que se han beneficiado de la refactorización: