Alexander
Alexander
Опять же. Известно, что для решения проблемы разработчики на других языках идут читать туториалы и документацию, а хаскеллисты идут читать пейперы.
Алексей
И вообще хаскель сложный язык.
NC
Не, в первую очередь иду на хакадж смотреть, не решил ли кто проблему до меня
NC
Пейперы это если уже отчаяние
Зигохистоморфный
Ну порой в пейперах есть интересные вещи. Не скажу что практически ценные, но как теоретика очень даже ок
NC
Да, после пейпера только
Timofey
Эм, нет, пейпер - это не документация
Timofey
Документация пишется в хаддоке
NC
На хаддоке удобнее всего сразу тыкать в Source
NC
там и норм ссылки на символы
Зигохистоморфный
Документация пишется в хаддоке
Или в основном не пишется, да и примеров использования толком нет. Один Гонзалес ещё что-то делает как примеры, так и доки
Timofey
К сожалению, да. Когда прочтения хаддока достаточно - это праздник
Timofey
A64m
откуда пейперобаязнь вообще? пейпер лучше чем средний интернетовыблев-"туториал", там хоть худо бедно как-то структурируется материал, ссылки на другие работы есть.
о каком отчаяньи речь-то?
NC
В тех пейперах, которых я копаюсь (3д графика) предлагаются лишь идеи как что-то сделать, реализацию пиши сам
A64m
Dmitry
NC
Код авторы пейперов, конечно же, никогда не прикладывают
Timofey
Я не обращал внимания на авторов нужных мне пакетов, но хорошие доки - редкость
A64m
Читать надо, думать :(
там надо думать в одной единственной главе, которая и нужна-то в основном имплементаторам фичи или для разрешения каких-то сложных вопросов, все остальное легкое чтение с шутейками
Влод
Влод
фазер наверное неправильно написал
NC
Влод
отцовская работа
NC
ну или наоборот
Dmitry
Вообще, накидайте @graninas плюсов. Вон, он уже второй день чятик поджигает!
Alexander
Лол :)
Anonymous
Combot
Λ y (0) увеличил репутацию Александр Гранин (2)
A64m
правда, это в основном касается всяких ФП-пейперов, другие часто бывают действительно суровыми
NC
NC
Combot
NC (0) увеличил репутацию Александр Гранин (3)
NC
Скоро тут будет как в Чёрном Зеркале
NC
https://hackage.haskell.org/package/mzv-0.1.0.2/docs/Control-Monad-RWS-Lazy.html
NC
Alexander
мне кстати гонзалесовые доки не удобны только путают
Alexander
директория examples в этом отношении лучше
Alexander
но это не про пейперы
NC
Комплияемые примеры лучше, чем туториал модули, да
Alexander
кукбуки где написано, как, а не почему, нужны конечно, но если такое будет в пейперах то язык можно закапывать
A64m
и доктесты
A64m
лучше некомпиляемых примеров в доках вообще не делать, они мгновенно сгнивают и потом только путаницу создают
Anonymous
зато они сразу на виду. Помогают быстро решить, пробовать либу или нет.
конечно, лучше взять пример из рабочего теста.
A64m
речь про специфический гонзалес-стайл туториал, а не про блогпосты его
Alexander
да
Alexander
мне нравится питоний формат cookbook для этого
Alexander
отдельные примеры, которые компилятся и лежат отдельным документом и решают типовые задачи
Alexander
из хаскель пакетов optparse-applicative например нормальное
Alexander
там Readme описывает кучу примеров, потом уже нормально по хаддокам лазаешь
Alexander
просто примеры это нужная, но другая форма документации
Alexander
не понимаю почему ее требуют от хаддоков и пейперов
Aliester
стоит ли читать скул оф хаскель?
Alexander
Да я уж подумываю открыть консультационный бизнес по Haskell, где я буду писать нормальные доки для людей. Потому что пейперов уже полно, а документации все равно не хватает. И не только по каким-то отдельным элементам языка или либам, но и по тому (в особенности по тому), как это все в комплексе использовать
Aliester
почему https://wiki.haskell.org/Learning_Haskell на половину состоит со старья и битых ссылок?
A64m
в смысле, по архитектурке? как для ооп что-ли?
Aliester
FP Patterns Remastered
A64m
Alexander
Aliester
а где брать инфу?
A64m
Да, это тоже
по моему эта вся литература по ооп совсем бестолковая
A64m
такого вообще быть не должно
Alexander
Давайте я Patreon открою и буду Haskell-доки писать full time, сайт поддерживать, инфу со всех уголков интернета в одном месте оформлять и облагораживать.
Alexander
Ну или может, FP Complete такую должность введет.
A64m
напишите какой-то док для примера, посмотрим нужно ли такое продолжать делать
Alexander
Я очень много доков уже написал разных, все доступно онлайн
Aliester
A64m
как их найти?
Ю ли я? 🤔
Leonid 🦇