Max Home IndustryОкно для заявок на сезон Google Docs 2020 приближается, и организации-наставники смогут начать подавать заявки в Google с 13 апреля. Сезон документов-это проект, поддерживаемый Google, целью которого является объединение организаций с открытым исходным кодом и технических авторов.
Объединив технических авторов и проекты с открытым исходным кодом, Google надеется улучшить качество документации с открытым исходным кодом. С другой стороны, цель состоит в том, чтобы дать техническим писателям возможность получить опыт участия в проектах с открытым исходным кодом и узнать об открытом исходном коде.
Идея, лежащая в основе этой схемы, заключается в том, что многие разработчики откладывают использование программного обеспечения с открытым исходным кодом из-за плохой документации; Google говорит, что их исследование показало, что 93% опрошенных разработчиков говорят, что “неполная или устаревшая документация является распространенной проблемой” в программном обеспечении с открытым исходным кодом, и что отсутствие документации было главной причиной, по которой разработчики решили отказаться от использования проекта с открытым исходным кодом.
В успешном сезоне проекта Docs технические авторы и наставники работают вместе, чтобы создать новый набор документов, улучшить структуру существующих документов, разработать учебник или улучшить процессы и руководства по вкладу. Стимулы для участия приходят в виде того, что Google выплачивает техническим писателям стипендию, а организации также могут получать стипендию в размере 500 долларов США за каждого технического писателя, которого обучают.
Первый сезон Docs был проведен в прошлом году и привел к 44 успешным проектам документации. Отзывы участников также были очень обнадеживающими:
91,7% наставников имели положительный опыт и хотят снова стать наставниками в будущем сезоне циклов Docs
88% технических писателей имели положительный опыт
96% планируют продолжать вносить свой вклад в проекты с открытым исходным кодом
100% технических авторов заявили, что сезон документов помог улучшить их знания кода и/или открытого исходного кода
Среди успешных проектов в прошлом году были обновления документации для Apache Airflow и Cassandra, работа над онлайн-руководством LibreOffice и руководство для начинающих по NumPy. Другие проекты документировали сторонние библиотеки для Arduino, создали учебник для начинающих для PostgreSQL и документацию по началу работы для людей, желающих получить доступ к данным Ensembl через REST API.