Документация по переполнению стека находится в стадии бета-тестирования

Опираясь на успех своих сообществ вопросов и ответов, Stack Overflow объявил , что его новый продукт Documentation теперь находится в стадии бета-тестирования. В течение последних восьми лет сайт вознаграждает советы экспертов, размещая высококачественные ответы в топе и позволяя пользователям зарабатывать очки репутации. Эта формула оказалась более успешной, чем традиционные форумы, где зачастую трудно, а то и невозможно определить качество ответов на вопросы.

Документация Stack Overflow курируется сообществом и фокусируется на предоставлении примеров кода для разработчиков. Он предлагает управление версиями, совместную разработку и голосование, что помогает выявить лучшие вклады. Сегмент документации на сайте имеет новый набор значков репутации и открыт для предложений и отзывов от всех.

«Документация дает дом большому количеству этого хорошего контента, который был отвергнут или очень трудно «правильно сделать» в формате вопросов и ответов. А именно, канонический, общий справочный, учебный контент», — сказал в объявлении разработчик Stack Overflow Кевин Монтроуз.

«Это вызвано необходимостью и самоисцелением», — сказал Монтроуз. «Лучший, самый прилежный технический писатель все еще не может победить тысячи реальных пользователей, пытающихся изучить функцию или концепцию при написании реального кода. Они определят, какие темы или примеры нужны больше всего. И всякий раз, когда что-то не может объяснить что-то ясно, они могут попросить, чтобы это было улучшено».

WordPress Stack Exchange — это процветающее сообщество, и тег документации WordPress уже активен на Stack Overflow с 10 темами, 12 запросами тем и 13 предложенными. Примеры тем на данный момент включают Loop, регистрацию пользовательских типов сообщений, выполнение сетевых запросов с помощью HTTP API и постановку сценариев в очередь.

Потребуются месяцы, если не годы, чтобы документация Stack Overflow WordPress хотя бы приблизилась к количеству официальной документации на WordPress.org, но у сайта есть потенциал стать ценным альтернативным ресурсом. Тот факт, что любой может присоединиться и внести свой вклад, используя существующую учетную запись Stack Overflow, делает барьер для входа очень низким.

«Исходя из моего многолетнего опыта работы с документами WP, я вижу серьезную проблему, связанную с тем, что люди снова и снова используют фрагменты кода, в то время как они уже давно устарели», — сказал Андрей Савченко, давний участник и модератор WordPress Stack Exchange.

«Однако мое первое впечатление таково, что пользоваться документацией значительно сложнее, чем сайтами вопросов и ответов», — сказал он. «Потребуется некоторое время, чтобы увидеть, будет ли легче внести свой вклад, чем, скажем, Codex и Devhub, а также удастся ли собрать сообщество экспертов WP для постоянного участия».

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

Если Stack Overflow сможет мотивировать разработчиков писать документацию с тем же успехом, что и сайты вопросов и ответов, компания потенциально может рассмотреть возможность добавления этой функции в свою версию Enterprise , которая создана для поддержки частных экземпляров 500 и более пользователей.