и я не то чтобы сторонник вики на гитхабе вести, просто для полноты упомянул )

А я как раз ищу прос/конс по вики

Вики хорошо когда с допплагинами

это вики на гитхабе, там нет плагинов

У нас например в редмайне в страничку v_18_07 подтягиваюся статусы тикетов этой версии

А это уже больно, там нужны генераторы

то же самое можно макросом в конфу подтянуть

вот это я писал

> Nick Volynkin edited this page on 24 Jun 2015 · 45 revisions

В смысле, что там и генераторов нет. Только маркдаун, из которого Гитхаб сам делает странички.

давайте обсудим эту тему )

Не, экосистема у гитхаба дальше гита грустновата

Ну да. А ещё, кажется, никто не заходит на эти вики-страницы в гитхабе.

Вот Readme на первой странице все видят.

Очень мало у кого это читаемо. Плюс к сожалению в каждой второй вики страница «список всех страниц» полезнее чем та структура, которую сделали руками

🤦‍♂️ Отдельная тема, кстати — как сделать удобную структуру.

Дико раздражает, что ссылка на вики в Гитхабе по умолчанию активна. А вручную не все её отключают, если там пусто. И вот ты такой жмёшь на ссылку — а там пусто.

Я часто вижу, что вики используют неправильно. В неё нельзя засовывать документацию, ибо она не будет версионироваться вместе с кодом. Но в вики можно закидывать просто полезную инфу. Кроме того, в Гитхабе доступ на редактирование можно открыть всем. Пара примеров страниц, редактируемых сообществом:
https://github.com/Seldaek/monolog/wiki/Third-Party-Packages
https://github.com/lord/slate/wiki/Slate-in-the-Wild

Основное назначение вики — подсказки и полезные ссылки. Из вики не нужно делать хранилище технической документации.

а как же прекрасный джекилл? :3