По п.2 вижу такой план действий —
- выбрать исходный формат (предлагаю markdown)
- разработать структуру каталогов (т.е. определить как будут формироваться и распределяться по файлам разделы/подразделы/статьи). Структура должна быть понятна интуитивно и проста для навигации через ГитХаб.
- определить где хранить иллюстрации.
- решить, что будем делать с текстами текущих комментариев к страницам (если таковые есть и полезны для общественности)
- сделать тест — перенести какую-либо статью, посмотреть все ли форматирование можно уместить в формат MD и структуры каталогов.
- Определить объем переносимой информации (например надо ли указывать авторство, как сейчас)
- сделать автоматизацию конвертации и переноса текущей документации на гитхаб (могу взяться)
- определить функции и основные моменты реализации плагина для просмотра дкументации на страницах cotonti.com — использовать ли хуки гитхаба для обновления инфы, как кешировать
- определить что делаем с комментариями: будем ли оставлять комментарии и как их реализовать, как сейчас или ссылкой на соотв. ветку форума, еще что-то.
Что я забыл?
Добавлено 1 минуты спустя:
зы. Тема номер 2 на мой взгляд сейчас гораздо актуальнее первой.
