hexlet / hexletguides.github.io Goto Github PK

в начале гайда нужно сделать блок "Содержание" который будет строится на основе подзаголовков h2-6 и будет содержать якорные ссылки на указанные пункты статьи

https://guides.hexlet.io/compiler/
В гайд нужно добавить пункт "что такое интерпретатор" в нем написать, что такое интерпретатор и отдельным подпунктом "чем компилятор отличается от интерпретатора "
можно это сделать в конце статьи, перед выводами

Если в заголовке имеются кавычки, они могут сломать некоторые теги для соцсетей. Пример того что получилось в коде, и при шаринге ссылки:

При наведении на такой блок https://puu.sh/xQuK6/447e905d87.png, не нужно сдвигать текст вправо.

https://quickref.dev/

Возможно стоит дать пояснение что ПР-с велкам

_posts/2019-02-25-how-to-be-a-helpful-for-the-hexlet-community.md

• https://github.com/Hexlet/hexlet-comparator
• https://github.com/Hexlet/jsbrowser
• https://github.com/Hexlet/RestApiTutorial.ru
• https://github.com/Hexlet/react-flowbot-ui-kit

Ссылки на внешние сервисы открываются в этом же окне, а стоит открывать в новом

Ссылки в блоке "Содержание страницы" ведут на внешние ресурсы (сайты по ссылке), вместо того чтобы прокручивать страницу к нужному абзацу. Это непривычно и мешает нормальной навигации по странице.

Стоит поправить ссылку на верную
Добавить ссылку на курсы\профессию

https://guides.hexlet.io/ssh/
в гайд нужно добавить пункт "чем telnet отличается от ssh"
отдельным параграфом, с подзаголовком. Можно в конец статьи, перед доп ссылками

Хорошо бы внутрь гайда добавить быструю ссылку на исходный код, чтобы можно было легко править очепятки

https://guides.hexlet.io/how-to-be-a-helpful-for-the-hexlet-community/
https://github.com/Hexlet/interactive-courses

• Добавить информацию про установку
• Добавить информацию про наименование файлов
• Вкладывание одного файла в другой

Стоит добавить ссылки на репозитории, чтобы можно было сразу перейти, форкнуть и вносить изменения.

• http://www.paulboxley.com/blog/2011/06/git-caret-and-tilde
• https://stackoverflow.com/a/2222920/3123272

Без каверов в рекомендациях некрасиво отображаются карточки статей. Нужны изображения и cover url в каждом гайде, чтобы рекомендации были красивыми и привлекали внимание.

https://guides.hexlet.io/vim/
нужно добавить либо в существующий гайд либо сделать отдельный со "шпаргалкой по Vim" (хоткеи и основные команды)

в гайде есть картинка, но она мелкая и её содержимое лучше сделать текстом, это я могу сделать сам, если дадите источник