24.05.2017 Экспертиза, Менеджмент, Открытый код/LinuxНередко открытые разработки не получают объективно заслуженной популярности по совершенно банальной причине — их документация никуда не годится. Не исключено, что именно по этой причине такому важному аспекту Open Source сейчас уделяется особое внимание. В частности, один из докладов на конференции OSCON был посвящён этой теме. Бен Холл (проекты Katacoda и Ocelot Uproar) изложил свою точку зрения на важнейший для всего сообщества вопрос. С его точки зрения, документация — это значительно большее, чем многостраничное руководство, которое предлагается прочесть всем пользователям продукта. Люди сначала смотрят, что написано на первой странице официального сайта или раздела GitHub. Одна из больших и, к сожалению, распространённых ошибок открытых проектов заключается в том, что пользователю предлагается пакет, в который входят ...
читать далее.