View source for Вики Рефакторинг

{{TOC}}

=== Что такое ===
**ВикиРефакторинг** -- это единственный известный сейчас мне способ избежать превращения нашей базы знаний в кучу знаний. Способ этот предполагает ответственность за владение документом и некоторую культуру этого владения.

=== Краткое описание ===
В такой среде, как вики, которую править может кто угодно, и ((ВикиДискуссия дискуссии)) ведутся прямо в теле документа, там же что-то ((ВикиТуду вычёркивается)), расставляются какие-то ((ВикиМаркер временные пометки)) -- любой документ в скором времени превращается в совершенно нечитаемое месиво. Пара человек, наиболее активно участвовавших в дискуссии ещё могут в нём разобраться, но человеку со стороны это уже не под силу.
  * Грустный пример -- оригинальная вики https://wiki.c2.com/ содержит ((http://wiki.c2.com/?RefactoringImprovingTheDesignOfExistingCode вот такие тексты))

Во избежание этого каждому (именно КАЖДОМУ!) документу вики необходим периодический пересмотр и коррекция. Назовём это рефакторингом. Кто этим займётся? Администратор этой вики? Он что, больной? =) Это ж такая куча документов!... Неужели выхода нет?
  * ??Выход есть!?? У каждого документа есть владелец, которому эта задача должна оказаться по силам. Ему ведь нужно присматривать только за своими документами. Или сдержать свои графоманские позывы и не плодить их столько, чтобы не смочь держать их "в теле".

=== Элементы паттерна ===
  1. **Документ** -- любая и каждая из страниц в вики.
  2. **Ответственный за документ** -- владелец этого документа. Если последний не чувствует себя ответственным, он вправе передать управление (вместе со владением) другому пользователю. 
  3. **Период рефакторинга** -- нельзя сказать, что документ нужно корректировать раз в месяц. Хотя почему нельзя? =)... Месяц неплохой срок -- как правило за это время ((ВикиДискуссия дискуссии)) поутихнут и наступит пора "причесать" документ.

=== Наведение порядка ===
Можно выделить несколько схем, по которым поддерживаются различные степени порядка документа и устраняются хаотические воздействия. Это: отражение атак вики-сквоттеров, приведение в соответствие паттернам (например, структуризация [[ВикиДискуссия идущих дискуссий]]), архивирование документа.

==== Отражение атак вики-сквоттеров ====
Время от времени на вики, открытые для всех, набегают странные персонажи, которые удаляют содержимое страниц, вставляют беспорядочные ссылки на свои (или чужие) сайты, пишут ругательства. Некоторые пытаются даже поселиться на месте, где только что были ваши документы.

Одним из путей является сильно ограничить возможности неавторизованных или того пуще -- незнакомых -- посетителей. Но во многих случаях это неприменимо или неудобно настолько, что приходится мириться с атаками. В таких случаях важно вовремя получить уведомление о такой атаке.

С этим прекрасно справляется сервис "наблюдения" за страницей. Найдите эту иконку/ссылку на этой странице и хорошенько запомните. Она вам пригодится. "Наблюдая" за страницей, вы будете получать по почте отчёты об изменениях наблюдаемых страниц и сможете своевременно отреагировать на атаку.

Конечно, если атаки будут повторяться, доступ к странице придётся прикрыть.

==== Приведение в соответствие паттернам ====
В особенности эта область рефакторинга касается ведения ((ВикиДискуссия дискуссий в теле документа)). Помните, что далеко не все участники в совершенстве владеют вака-разметкой и знают паттерн ВикиДискуссия. Поэтому многие дискуссии теряют свой аккуратный вид, если никто не "причёсывает" их, приводя в соответствие с предложенным в паттерне поведением.

Не обязательно ждать, пока владелец страницы причешет дискуссию -- займитесь этим сами, только постарайтесь не уничтожать реплик и сохранить нити разговора.

==== Архивация документа ====
Нет, не сжатие его, а устранение излишней, мешающей информации, касавшейся, например, потерявшей актуальность дискуссии или изменившейся точки зрения.

Когда пыл дискуссий поостыл, все решения приняты, необходимо зафиксировать результат так, чтобы потом им смогли пользоваться все те посетители, кто не присутствовал в дискуссии. Постарайтесь построить какое-то связное повествование из итогового материала, а дискуссии, если какие-то их элементы важно оставить в таком состоянии -- вынесите в поддокументы вида ##~!/ДискуссияПроПингвина##, ##~!/ОбсуждениеТретьейПоправки##, а в документе оставьте только ссылки, что-то вроде
  * см. также __!/ДискуссияПроПингвина__

----
См. также:
  * ((ВикиОтчётность))
  * ((ВикиДискуссия))