[Инициатива] Программа поддержки наполнения wiki
Проблема
Документация на wiki не поддерживается в должном виде. Множество аспектов Голоса там документированы очень плохо. Структурированность плохая.
Почему так происходит, я уже изложил в посте Проблемы opensource-проекта Голос. Повторю вкратце:
У участников проекта нет стимула наполнять wiki, потому что за это никто не платит, а вот за статьи можно получить неплохой гонорар. Поэтому практически все предпочитают писать именно статьи и получать профит.
В результате получается, что wiki поддерживается плохо, а статьи на Голосе устаревают и накапливаются, создаётся ситуация, что по какой-либо теме есть пачка статей разной степени протухлости, но читать надо все, потому что инфа не всегда перекрывается. А так же лучше и с комментами, потому что там тоже бывает много полезного. В результате временные затраты на изучение темы существенно возрастают, т.к. приходится перерывать тонны материала вместо чтения сути на wiki.
Вот например @siberianshamen возмущается о протухлости wiki, а между тем, на wiki не внесено ни одной статьи по проекту 50/50, "папой" которого он по сути является. Вместо этого он так же пишет FAQ-и, размещая их в виде статей, хотя очевидно, что описание проекта и FAQ просится на wiki.
Суть программы
Для решения вышеописанной проблемы предлагается объявить программу поддержки правок wiki. Работу этой программы я представляю следующим образом:
- Контибутор создаёт клон репозитория wiki и вносит правки
- Контибутор отправляет pull request в основной репозиторий wiki
- Контрибутор пишет статью с тегом #goloswiki по некоему шаблону, включая в неё исчерпывающую информация о вносимых правках:
- описание своих правок
- ссылку на свой форк wiki (например мой - https://bitfag.gitbooks.io/golos-wiki/content/)
- ссылку на pull-request
- В комментах происходит обсуждение и уточнение корректности вносимой информации
- Community своими апвотами обеспечивает выплату вознаграждения за труд контибутора.
Таким образом, получается community-driven программа поддержки, в рамках которой можно радикально улучшить и переработать wiki. Даже если владельцы wiki.golos.io не захотят мёржить наши правки, ничто не мешает нам разместить community wiki на собственном домене.
Community - это сила! Вместе мы можем многое.
