BB
Как думаете насколько безумна идея напсать книгу о эликсире прямо в hexdocs? это будет первая книга покрытая тестами 😄
Size: a a a
2018 November 30
ŹR
Вообщем насчет книжки хз, а выписать все задачки на Github’e с примерами быдо бы прикольно.
Код с комментариями это и есть книжка
ŹR
А код без комментариев не имеет смысла
ŹR
Просто закинул на амазон чтобы было удобнее читать
EA
Задача + код решения != книжка
EA
Я об этом говорю
ŹR
Задача + код решения != книжка
Ну так это не имеет особого смысла
BB
ну мы можем просто за экспортить из готовой документации в пдф красивый
ŹR
Как по мне
EA
Надо хотя бы это сделать
EA
А потом уже поговорим что там имеет или нет.
BB
ну соответсвоно весь текст главы будем в модуль доке скажем, или типо того. но это я так просто безумные идеи
EA
ну соответсвоно весь текст главы будем в модуль доке скажем, или типо того. но это я так просто безумные идеи
Да норм идея кстати
EA
У тебя есть кусок кода с решением, докой покрыл его и поехали.
ŹR
Так можно сделать, но будет кривовато. Комментарии не компилируются в доку, по сути там просто апи референс. Можно сделать в отдельных md файлах, но тогда смысл? Можно сделать в тех же файлах в moduledoc, но будет кашевато
ŹR
Легче сделать набор статей в md, но это тот же книга только разобранная
ŹR
Плюс в хекс ты все равно не пушнешь, а это значит что доки нужно будет где-то самому хостить
BB
А зачем нам хостить доку? мы можем просто в ее в epub закэкспортить. ну может потвикать что то придеться
ŹR
Так а зачем тогда писать внутри кода