Что доделать в целом #2
Description
Список желательных исправлений до того, как (если) мы решимся открывать эту версию для учащихся.
- длинный файл неудобен для чтения и навигации. github умеет генерировать оглавление для markdown-файлов, но оно доступно по кнопке слева вверху текста, которую никто не видит. Я бы вынес каждое задание в отдельный файл и сделал линки из корневого файла.
- задание 1 состоит из строчки "Изучить" и километрового 2-уровневого списка, который не влезает на экран. Нужно преобразовать это в подразделы или отдельные файлы.
- задания 2 это тоже касается
- информация про отчеты в чате затерялась где-то в конце задания 1. В маркдауне у нас нет списков-свитков, главу нельзя свернуть, чтобы показать структуру верхнего уровня. Нужно перенести эту информацию в начало задания 1 или даже до задания 1.
- общие технические требования для бота и сервера пометить анкором и сделать на него линк. Возможно, вынести в файл.
- починить битые ссылки (например, найдя архивные версии на archive.org):
- "Thinking Functionally with Haskell"
- https://tproger.ru/translations/telegram-bot-create-and-deploy/amp/
- Haskell Platform объявлена deprecated, а список ее либ больше недоступен, по ссылке открывается просто раздел Haskell Downloads. Надо явно перечислить список разрешенных либ, возможно, взяв его из archive.org. Желательно два списка (что точно разрешено, что точно запрещено) и у кого спросить, если хочется использовать либу, а не знаешь, можно ли.
- начало 4 задания какое-то куцее, надо переформулировать.
- в тексте упоминаются блипы из риззомы :)
- очень нужен гайд по установке хаскеля, часто спрашивают. У стека есть коварный нюанс: он не работает в windows под юзером, чье имя содержит пробелы и, возможно, кириллицу. Сложно представить, сколько народу у нас отсеялось из-за этого.
Менее срочно:
- предложить учащимся делать пулл-реквесты с добавлением новых кат, предложениями по программе, и поощрять задавать вопросы в issues. issues удобнее для поиска и обсуждения, чем чат. В риззоме кажется нормально было с вопросами и ответами, накопилась база информации.
- перестать писать про проект, с которого все началось, в настоящем времени, так как мы над ним больше не работаем. В этом есть маленькая неправда.