Что доделать в целом

[antonkalinin-ml]

Список желательных исправлений до того, как (если) мы решимся открывать эту версию для учащихся.

• длинный файл неудобен для чтения и навигации. 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 удобнее для поиска и обсуждения, чем чат. В риззоме кажется нормально было с вопросами и ответами, накопилась база информации.
• перестать писать про проект, с которого все началось, в настоящем времени, так как мы над ним больше не работаем. В этом есть маленькая неправда.

[evgeny-osipenko]

Надо явно перечислить список разрешенных либ, возможно, взяв его из archive.org.

Возможно, будет лучше сделать сразу два списка:

1. Библиотеки, которые точно разрешены.
2. Библиотеки, которые точно запрещены.
3. Если вы хотите использовать библиотеку, но её нет в этом списке - спросите в чате/откройте ишью.

[antonkalinin-ml]

Согласен. Только п. 3 пока нельзя осуществить на 100%: в чате сидит всего пара человек из нас, они не всегда могут увидеть вопрос, а гитхаб-версию стажировки мы еще не открываем стажерам. Если в чате захотят задать вопрос, скорее его зададут Свете, она есть в подписи запиненных сообщений :).