Как сейчас актуально создавать переводы документаций к новым инструментам разработки?

Question

[Олег]

Нередко натыкался на сайты типа таких:
https://nauchikus.github.io/typescript-definitive-...
https://rajdee.gitbooks.io/redux-in-russian/conten...

Конкретно здесь домен gitbook, но нередко встречал домены типа name.github.io.

Какие есть варианты создания такой документации, и какие из этих вариантов самые оптимальные (по скорости, удобству и т.д.)?

Answer 1

[Frozen Coder]

Первый вариант - это github pages. Хостинг небольших статических сайтов для проектов на гитхабе. Что будет на этом сайте и как вы его будете заполнять и вести - это ваше дело. Часто там ещё личные блоги делают. Используют какой-нибудь jekyll или аналоги. Это бесплатно. Т.е. тут надо больше ручками поработать. И если ваш сайт будет очень популярным, то вроде как могут попросить вас мигрировать куда-нибудь)
Второй вариант - это gitbook. Уже более специализированное решение, которое сразу даёт платформу из коробки, как я понимаю. Там даже есть платные решения со всякими готовыми плюшками. Есть что-то бесплатное, в том числе и для opensource. Посмотрите на сайте. Т.е. это проще и быстрее, но мб за что-то хорошее нужно доплатить. Не юзал, честно говоря.