[golos wiki] Краткий отчёт и предложения

Принятые изменения

С момента прошлой статьи о запуске инициативы по наполнению wiki было принято 2 pull request-а:

Дальнейшие планы по wiki

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

В общем, мною было поднято ряд проблем и предложений:

Реорганизация

Мои предложения по реорганизации, которые хотелось бы обсудить:

  1. Прекратить практику прямого копипаста. Это очень порочная практика. Берутся статьи с Голоса и прямым копипастом постятся в wiki. ЗАЧЕМ? Можно просто тогда уж поставить ссылку. Такие статьи протухают и править их страшенный геморрой. Проще переписать с нуля.
  2. Переписать статьи таким образом, чтобы они не были написаны от первого лица. Избавиться таким образом от п. 1.
  3. Пересмотреть оглавление, не допускать дублирования одной и той же темы в разных статьях. Часто сталкивался с тем, что инфа по одной теме размазана по нескольким статьям. Когда надо что-то перечитать, сидишь и тыкаешься в оглавление в поисках "той самой" статьи, которая содержит нужное. Помнишь, что читал, а в которой из статей - нет!
  4. Всё тухлое перенести в отдельный раздел "протухло" чтобы старьё не мозолило глаза и не пересекалось с актуальными данными. Лучше меньше, да лучше. Это изменение позволит чётко видеть, что актуально, а что нет.

Реструктуризация

Считаю, что текущее оглавление

  • АКТУАЛЬНОЕ
  • НОВИЧКАМ
  • ЭКОНОМИКА
  • ДОКУМЕНТЫ
  • ...

какое-то странное и с ним что-то не то. Хочется его переделать, но вот как именно, пока не придумал. Когда я задумался о распиле раздела "Разработчикам", возникла мысль, что в текущее оглавление моя идея не вписывается. Нужна другая структура, более логичная и чёткая. Грубое представление пока такое:

  • FAQ
  • Описание платформы - тут описание экономики, всё что нужно для пользователя
  • Клиенты - тут пользовательская документация по интерфейсам и т.п.
    • Руководство пользователя golos.io
    • Руководство пользователя goldvoice.club
  • ПО голоса
    • golosd
      • установка, настройка, запуск, running and operating - по сути, администрирование
      • подраздел для разработчиков ПО на базе блокчейна
        • API
    • Скрипты
      • скрипты для делегатов
    • Боты для telegram
      • golos notify
      • стопицот ботов vik-а
  • Жизнь на площадке
    • Описание тэгов
    • Что такое psk, vox-populi и прочие непонятные штуки
    • Программа 50/50

Заключение

  1. Сопровождение wiki, как и golosd ведётся не публично. Пора менять этот подход и начать публично договариваться о дальнейших планах, чтобы никто не прикладывал усилия впустую.
  2. community пора перестать надеяться на @cyberfund, "ждать ХардФорков" и начинать двигать платформу самостоятельно. Про это надо написать отдельно.
goloswiki
39
9.803 GOLOS
0
В избранное
vvk
Opensource. У меня в комментах можно материться. Второй блог "за жизнь" - @vvk-life
39
0

Зарегистрируйтесь, чтобы проголосовать за пост или написать комментарий

Авторы получают вознаграждение, когда пользователи голосуют за их посты. Голосующие читатели также получают вознаграждение за свои голоса.

Зарегистрироваться
Комментарии (12)
Сортировать по:
Сначала старые