Google представил инициативу по стимулированию написания документации для СПО
11 марта 2019 года
Компания Google анонсировала программу "Season of Docs", похожую на "Summer of Code", но нацеленную на подготовку документации для открытых проектов. Для участия в программе приглашаются технические писатели, которые совместно с кураторами из открытых проектов попытаются улучшить положение дел с документацией. В случае успешного завершения проекта участники получат (Архивная копия от 19 октября 2020 на Wayback Machine) вознаграждение, размером от 2400 до 6600 долларов, в зависимости от покупательной способности в стране, где проживает участник. Куратор из открытого проекта получит 500 долларов.
Со 2 по 23 апреля будут приниматься заявки на проведение работ от открытых проектов, после чего 30 апреля будет подготовлен список участвующих в программе проектов и их заданий. С 30 апреля по 28 июня технические писатели смогут выбрать проект и отправить заявку на участие. В течение августа технические писатели совместно с кураторами уточнят техническое задание, а на протяжении сентября, октября и ноября попытаются выполнить работу. 10 декабря будут подведены итоги и объявлены успешно выполнившие работу участники.
Кроме непосредственного написания пользовательской документации, в рамках проекта возможно и решение сопутствующих задач, таких как создание сайтов с документацией, переработка существующей документации, написание обзорных материалов, написание руководств для участников проекта и т.п. Для оформления документации рекомендован формат Markdown, но конечное решение зависит от пожеланий конкретных открытых проектов.
Источники[править]
Любой участник может оформить статью: добавить иллюстрации, викифицировать, заполнить шаблоны и добавить категории.
Любой редактор может снять этот шаблон после оформления и проверки.
Комментарии[править]
Если вы хотите сообщить о проблеме в статье (например, фактическая ошибка и т. д.), пожалуйста, используйте обычную страницу обсуждения.
Комментарии на этой странице могут не соответствовать политике нейтральной точки зрения, однако, пожалуйста, придерживайтесь темы и попытайтесь избежать брани, оскорбительных или подстрекательных комментариев. Попробуйте написать такие комментарии, которые заставят задуматься, будут проницательными или спорными. Цивилизованная дискуссия и вежливый спор делают страницу комментариев дружелюбным местом. Пожалуйста, подумайте об этом.
Несколько советов по оформлению реплик:
- Новые темы начинайте, пожалуйста, снизу.
- Используйте символ звёздочки «*» в начале строки для начала новой темы. Далее пишите свой текст.
- Для ответа в начале строки укажите на одну звёздочку больше, чем в предыдущей реплике.
- Пожалуйста, подписывайте все свои сообщения, используя четыре тильды (~~~~). При предварительном просмотре и сохранении они будут автоматически заменены на ваше имя и дату.
Обращаем ваше внимание, что комментарии не предназначены для размещения ссылок на внешние ресурсы не по теме статьи, которые могут быть удалены или скрыты любым участником. Тем не менее, на странице комментариев вы можете сообщить о статьях в СМИ, которые ссылаются на эту заметку, а также о её обсуждении на сторонних ресурсах.
