senjun-courses icon indicating copy to clipboard operation
senjun-courses copied to clipboard

Haskell course: description, meta, first 6 chapters

Open Microvenator opened this issue 1 year ago • 0 comments

Книга Дениса Шевченко @denisshevchenko О Haskell по-человечески по частям приезжает к нам в проект в виде курса. На гитхабе это проект ohaskell.guide. С добавлением задач и минимально необходимым подстраиванием под формат курса.

В этом реквесте

В формат курса адаптированы первые 8 глав книги. Получилось 6 глав курса с 17-ю задачами.

Книжные глава 1 "Приветствую!", глава 2 "Первые вопросы" и глава 3 "Об этой книге" скомпонованы в 1 главу курса "Введение".

Далее 1-к-1, только переименована глава 4.

Что поменялось

  • Добавлено несколько микро-дополнений и по тексту. И одно нано-обновление, касающееся дефолтного наполнения проекта, который создает stack.
  • Добавлены задачи и необходимая для их решения информация.
  • Так как курс интерактивный с online IDE, то для прохождения курса париться с установкой stack не нужно. Информация про развертывание инфраструктуры будет дана под конец курса, чтобы отправить пользователя в свободное плавание.
  • Вместо блока "Об авторе" у автора появится полноценная страничка.
  • Блоки, касающиеся описания книги, убраны. Вместо них описание курса (description.md)
  • Вместо вот таких блоков:
prod    :: Int      -> Int      -> Int

имя        тип         тип         тип
функции    первого     второго     вычисленного
           аргумента   аргумента   значения

пояснения переехали в текст. Это нужно, чтобы пользователям, которые проходят курс из телеграма с мелких экранов, тоже было удобно.

Как это будет выглядеть

Часть данных для отображения не входит в этот реквест. Они в нашей внутренней репе для бэка.

"О курсе" в списке курсов haskell_about

"Об авторе" haskell_about_author

Оглавление haskell_chapters

Как выглядят главы внутри haskell_chapter_contents_1 haskell_chapter_contents_2

Microvenator avatar Apr 28 '24 13:04 Microvenator