Max Home IndustryСезон документов-это проект, поддерживаемый Google, целью которого является объединение организаций с открытым исходным кодом и технических авторов с целью улучшения документации с открытым исходным кодом. Теперь объявлены результаты второго сезона 2020 года.
Идея, мотивирующая сезон документов, заключается в том, что отсутствие четкой и надежной документации является одним из главных недостатков многих проектов с открытым исходным кодом. Чтобы исправить это, Google решил поощрить технических писателей приобретать опыт участия в проектах с открытым исходным кодом. Стимулами, предлагаемыми писателям, являются стипендии в размере 6000 долларов США или эквивалентная покупательная способность в местной валюте. Участвующие организации OSS также могут получать стипендию в размере 500 долларов США за каждого технического писателя, которого обучают. Одна из пар технических авторов и наставников работает вместе над созданием новой документации, улучшением структуры существующих документов, разработкой учебника или улучшением процессов и руководств по вкладу.
Первый сезон Docs в 2019-20 годах привел к 44 успешным проектам документации. Вторая программа была расширена, и теперь Google сообщила о результатах программы 2020 года для проектов стандартной длины, для которых этап написания был с сентября по ноябрь 2020 года, завершенный 64 техническими авторами для 42 организаций OSS. Еще 18 проектов, которые потребовали дополнительного времени, продолжатся до марта 2021 года.
Просмотр списка успешных проектов показывает широкий спектр проектов. Некоторые из них представляют собой обновления, усовершенствования или реструктуризацию существующей документации, в то время как другие начинаются с нуля. Некоторые проекты должны предоставлять наборы примеров или учебных пособий, в то время как другие создают портал или базу знаний для доступа к таким материалам.
Список организаций, участвующих в OSS, включает в себя множество известных организаций: Cloud Native Computing Foundation, Creative Commons, LibreOffice, MicroPython, NumPy, Язык Julia и Фонд Linix. Проект Фонда Викимедиа состоял в том, чтобы улучшить свои процессы адаптации и стандарты документации, и еще одним, что привлекло мое внимание, было Руководство по информационной архитектуре для проекта Gooddocsproject, цель которого состоит в том, чтобы помочь людям использовать шаблоны проектов Good Docs для создания документации для своих собственных проектов.
Все проекты, которые я отобрал, оказались хорошо продуманными и отвечали высоким стандартам, способствуя общей цели повышения качества документации с открытым исходным кодом.
Еще одна цель Google для Сезона документов-это укрепление долгосрочных отношений между техническими авторами и открытым исходным кодом. Результаты, полученные до сих пор, свидетельствуют о том, что это успешно. В конце первого выпуска 2019 года мы передали новость о том, что 88% технических авторов имеют положительный опыт и что 96% планируют продолжать вносить свой вклад в проекты с открытым исходным кодом. Результаты на 2020 год еще лучше:
96% технических писателей имели положительный опыт
96% планируют продолжать вносить свой вклад в проекты с открытым исходным кодом