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