Улучшения, показаны 27 из 27.
Программа берет настройки из нестандартных переменных окружения. Их не угадать без чтения кода.
При чтении документации пользователя интересует как установить программу и как её запустить. Разобраться в документации …
Если ссылка в документе есть, но кликнуть по ней нельзя, то придется выделить и скопировать …
При чтении документации пользователя прежде всего интересует как установить программу.
В Markdown разметке легко ошибиться — поставьте один лишний символ \` и вы сломаете форматирование …
Названия переменных, код и консольные команды внутри документации принято оформлять особым образом — как вставки …
Подсветка синтаксиса заметно облегчает чтение кода. Сразу становится видно где вызвана функция, где начинается цикл …
Когда в документации один текст, тратится много времени на прочтение, чтобы узнать, например, как установить …
Документация — тоже часть кода. За ней тоже стоит следить и ухаживать.
Никто не будет использовать ваш код, если вы не расскажете, что он делает. Поэтому в …
Точка в конце предложения обозначает конец одной мысли и начало следующей. Это элемент форматирования текста, …
Чем больше информации в документе, тем сложнее его понять. Бывает, что в документе всё на …
Если программа требует данных в особом формате, то пользователю надо их взять откуда-то или подготовить …
Ваш заказчик хотел, чтобы сайт был доступен оффлайн. В репозитории есть код, какие-то файлы, но …
В Markdown есть два формата для вставок кода. Первый — это inlines. Его применяют для …
Разметку Markdown любят за её выразительность и простоту. В сравнении с HTML здесь не надо …
В тексте и список, и абзацы решают одну задачу - задают структуру текста, разбивая его …
Знаки препинания в конце заголовка могут быть признаком плохого тона, а иногда даже признаком неграмотности. …
README — это лицо проекта. От его вида и содержания сразу же складывается первое впечатление, …
В README не хватает ссылки на демонстрационную версию сайта. Развёртывание публичной версии сайта было частью …
Заголовки -- это особый элемент форматирования текста. Он предназначен для выделения главной мысли в абзаце, …
Локальные настройки проекта не должны попасть в общий репозиторий. Самый простой и надёжный способ этого …
Ссылки можно оформлять множеством разных способов. Но когда вы встраиваете ссылки в текст, важно оформлять …
Инструкции в документации неполны либо содержат ошибки. Возможно, инструкции просто устарели со временем. Воспринимайте инструкции …
Заголовки -- это особый элемент форматирования текста. Он предназначен для выделения главной мысли в абзаце, …
Любой текст можно "убить" перегруженными предложениями. Читатель читает слева направо, а не из конца предложения …