WackoWiki: Вики Рефакторинг

https://wackowiki.org/doc     Version: 6 (03.08.2020 09:57)

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


Что такое

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

Краткое описание

В такой среде, как вики, которую править может кто угодно, и дискуссии[link1] ведутся прямо в теле документа, там же что-то вычёркивается[link2], расставляются какие-то временные пометки[link3] -- любой документ в скором времени превращается в совершенно нечитаемое месиво. Пара человек, наиболее активно участвовавших в дискуссии ещё могут в нём разобраться, но человеку со стороны это уже не под силу.

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

Элементы паттерна

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

Наведение порядка

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

Отражение атак вики-сквоттеров

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

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

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

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

Приведение в соответствие паттернам

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

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

Архивация документа

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

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

См. также: