- Выпилить команду проверки орфографии. Позже заменить на актуальную.
- Выпилить Докер из предпросмотра. UPD: или не выпиливать, а просто оставить как самый последний способ запустить проект локально. Для Windows апдейтнуть команды и указать, что работает только с WSL.
- Акцентировать внимание на том, что можно смело юзать чистый Маркдаун.
- Упростить тексты.
- Очень много ссылок разбросано по текстам инструкций. Уменьшить бы, собрать в одном месте, возможно.
- Сложная организация инструкций. Часть хранится в платформе, часть — в контенте. Из-за этого по ним сложно ориентироваться. ❓ Отдельное репо для инструкций, в ридми контента и платформы оставить только самое главное и дать ссылку на репо с инструкциями ❓
- Разбавить тексты схемами (и, возможно, иллюстрациями).
- Решать проблемы также автоматически, а не через инструкции. К примеру, создание папки автора.
Организация инструкций сейчас
platform
README.md
⊤ docs
README.md
deploy.md
deps.md
how-its-work.md
how-to-run.md
license.md
load-fix.md
content
README.md
⊤ docs
⊤ demos
⊢ images
index.md
style.md
⊤ examples
article.md
doka.md
⊢ images
README.md
api.md
contributing.md
interviews.md
license.md
load-fix.md
people.md
practice.md
preview.md
schemes.md
speller.md
styleguide.md