Веб-разработка ради людей

Wiki-системы, багтрекеры, системы контроля версий являются эффективными инструментами для разработчиков, но начинают сильно сдавать, когда в команду попадает нетехнический специалист с навыками на уровне пользования Microsoft Word.

Не каждый такой человек может легко принять технические сложности: необходимость выучить разметку, необходимость делать какие-то ещё действия.

С разметкой зачастую больше всего проблем - человек просто думает другими категориями, у него в голове нет понятия “тег A”, он хочет “ссылку на другой документ”.

Как можно облегчить эту задачу? Визуальными средствами.

На примере wiki это легко сделать - при вставке ссылки нужно спросить пользователя, является ли эта ссылка внутренней или внешней (ведёт на другой сайт). Если ссылка внешняя, нужно запросить адрес и текст ссылки. А если внутренняя, то можно значительно облегчить задачу, предоставив пользователю древовидный список всех имеющихся в текущем разделе документов (с возможностью выхода на уровень выwе и так далее).

При описаном подходе появляется проблема с документами, которые не существуют на момент создания ссылки, что является нормальной для wiki практикой. Как ни странно, для устранения непонимания в таких случаях нужно ввести требование существования документа перед созданием ссылки - то есть, пользователь должен сначала создать документ, а потом ссылаться на него.

Кроме прочего, это устранит и ошибки, так как все адреса будут выбираться из списка, а не вводиться вручную.

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

Если выводится короткое сообщение “Произошла ошибка.” - это ему не понравится даже ещё больше, потому что здесь ему даже подумать не над чем.

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

Если ошибка программы - уведомить об этом пользователя, написать,
что ошибка произошла именно на сервере, и он тут ни при чём.

Если же это пользователь сделал что-то такое, чего емy делать
не нужно, то ему также нужно об этом явно сообщить.

Также нужно явно указать,
является ли сбой кратковременным,
и в ближайшие несколько минут всё будет
в порядке, или же ошибка принципиальная,
и без вмешательства программистов исправлена быть не может.

То есть, человек должен знать, нужно ли ему что-то исправлять, или же можно уходить с этой страницы, потому что ошибка прямо сейчас не может быть исправлена.

В любом случае, ваши сообщения об ошибках должны стать подарком для пользователя, а не наказанием.