La refactorización es un proceso de nueva redacción en el que el contenido de la página de discusión se mueve, elimina, revisa, reestructura, oculta o cambia de otro modo. Se aplica solo en contextos donde los editores hacen declaraciones firmadas (como en los espacios de nombres Talk y User talk ).
La refactorización tiene varios usos, que incluyen:
La refactorización es más asertiva que la edición de copias , pero menos sustancial que el archivado . Al igual que la edición de textos, siempre conserva el significado y la intención del editor original. Al igual que el archivo, puede ocultar material de la visibilidad inmediata. Debe utilizarse como herramienta para separar material innecesario de una discusión sobre la marcha , sin esperar a que se archive formalmente 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 para mantener una página de discusión productiva. Las páginas de discusión que son confusas, hostiles, demasiado complejas, mal estructuradas o congestionadas con conversaciones cruzadas pueden desalentar a los posibles contribuyentes y crear malentendidos que socavan las discusiones fructíferas.
La refactorización solo debe realizarse cuando los editores que han contribuido a la página de discusión asuman buena fe . Si hay discusiones acaloradas recientes en la página de discusión, es posible que falte buena fe. Si otro editor se opone a cualquier 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 las secciones dentro de ella sin refactorizarla.
Anteriormente en la historia de Wikipedia, y particularmente antes de 2006, el contenido de las páginas de discusión se resumía para conservar espacio, un método de refactorización no conservador. Sin embargo, la comunidad ha llegado a preferir el archivo completo de las discusiones de las páginas de discusión, ya que el archivo preserva un registro más completo de la discusión, no da lugar a tergiversaciones (accidentales o perjudiciales) de las opiniones de otros editores y conserva material que puede ser útil en el futuro. . El mismo principio se ha aplicado a la refactorización de manera más amplia.
Como regla general, los editores no deben editar los comentarios de los demás de manera que afecten el significado; hacerlo crea tergiversaciones, interrumpe el flujo de las conversaciones y hace imposible seguir los debates y discusiones, pero existen casos en los que los comentarios de un editor deben eliminarse de el 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é seguro de que el otro editor le agradecerá el esfuerzo, en lugar de enfadarse.
Reestructuración : debe hacerse con cuidado para evitar cambios de significado.
Poda de texto : solo debe realizarse con el consentimiento del autor original o con 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 formaba parte de discusiones de otros editores. Consulte WP:Diff para obtener orientación sobre cómo crear un enlace al historial de la página y WP:Pautas de la página de conversación#Comportamiento que es inaceptable para obtener orientación sobre contenido inapropiado de 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 utilizada debe elegirse según las necesidades particulares del material.
Se recomienda la creación de preguntas frecuentes para cualquier punto que probablemente se plantee y refactorice repetidamente. El material existente debe generalizarse adecuadamente y reformatearse en un formato simple de pregunta/respuesta para que los editores posteriores puedan satisfacer sus inquietudes sin volver a plantear la pregunta. Del mismo modo, las discusiones prolongadas y en curso podrían 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, la discusión debe dividirse en nuevas secciones o subsecciones. Esto resulta útil cuando una sección se vuelve demasiado larga o cuando la conversación comienza a desviarse en varios puntos separados. La resección puede ayudar tanto a los lectores como a los participantes a comprender el flujo de la discusión y ayudarlos a encontrar partes relevantes del texto.
En discusiones largas, los participantes suelen insertar pausas arbitrarias añadiendo un nuevo título de subsección. De hecho, estas pausas suelen recibir títulos como "pausa arbitraria" o "pausa de conveniencia", con un número de índice para distinguirlas de otros encabezados de pausa arbitraria. Por el contrario, las discusiones que cubren múltiples puntos o se vuelven más complejas pueden beneficiarse de la creación de subsecciones para abordar diferentes puntos o, en casos extremos, de dividir secciones de texto en secciones completamente nuevas. En estos casos, puede ser necesario reorganizar grandes fragmentos de texto y, de ser así, se debe tener cuidado de garantizar que ningún comentario se saque de contexto o pierda conexión con el punto original que estaban abordando. Puede ser aconsejable copiar secciones de texto en lugar de moverlas (agregando un comentario que haga referencia 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.
Se deben considerar estas preocupaciones 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 realmente dijo el autor. Esta combinación de refactorización y archivado a menudo evitará quejas de pérdida de información. Deje explícito que ha refactorizado algo para que nadie se engañe haciéndoles creer que esta era la página de discusión original.
Si cree que las personas pueden 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 la Discusión:Nuevo Imperialismo , cree una nueva página titulada [[Discusión:Nuevo Imperialismo/Resumen de los archivos 7 a 10]]. Vincula esto a la parte superior de los archivos correspondientes y a la página de discusión actual. Esto brinda a los recién llegados la oportunidad de obtener una comprensión rápida sin el riesgo de perder lo anterior. Tener un archivo vinculado puede ayudar a satisfacer tanto a quienes sienten que sus palabras deben permanecer intactas como a quienes desean un resumen ordenado.
Se puede realizar fácilmente una refactorización simple con la edición estándar del navegador 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 resultar de gran ayuda. Básicamente, cualquier herramienta que tenga funciones ampliadas de búsqueda y reemplazo, capacidades de expresión regular o procesamiento de texto programático se convertirá en su mejor amiga. Alfabetizar material, clasificar secciones en orden cronológico, cambiar múltiples enlaces, reestructurar tablas grandes: estas tareas pueden ser difíciles y consumir mucho tiempo si se realizan a mano, pero se pueden realizar en cuestión de minutos mediante programación. La mayoría de los editores de texto de alta gama tipo 'Office' tienen capacidades avanzadas de edición de texto y hay disponibles muchas aplicaciones de edición de texto livianas pero potentes; consulte la lista de editores de texto . También existen muchos lenguajes de programación para el procesamiento de textos; Los más comunes son Perl , Python , scripts de shell Unix y AppleScript .
Para trabajos de refactorización prolongados, puede resultar útil etiquetar las páginas que se están refactorizando con Plantilla:En uso . Simplemente agréguelo {{in use}}a la parte superior de la(s) página(s). 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: