Каталог команд Fedora

Чтобы обеспечить видимость того, какие команды существуют и активны в Fedora, Fedora Council решил вести каталог, который регулярно проверяется. Представители Fedora Council несут ответственность за периодическую оценку команд в своих областях (DEI, Engineering и Mindshare). Под «Командами» следует понимать обобщающий термин для групп в Fedora, которые могут называть себя «Группами специальных интересов (SIG)», «Рабочими группами (WG)» или любым другим подобным термином.

Назначение

Каталог команд предназначен для обеспечения видимости:

  1. Какие команды активны в сообществе.

  2. Как с ними связаться.

Fedora — это большое сообщество с множеством различных видов деятельности, и каталог поможет существующим и потенциальным участникам сообщества найти нужную команду. Регулярные проверки помогают гарантировать точность информации и то, что мы не направляем людей в команды, которые больше не активны.

Назначение не состоит в увеличении административной нагрузки на команды или в создании барьеров для создания новой команды. Назначение не состоит в том, чтобы сказать: «если вы не указаны в каталоге, вы не можете быть командой в Fedora». Однако наличие в каталоге может использоваться другими командами для оценки запросов на финансирование или работу (например, работы над веб-сайтом или дизайнерских материалов).

Содержимое

Команды должны указывать следующую информацию в формате, определённом шаблоном:

  • Название команды

  • Краткое описание команды

  • Веб-сайт команды

  • Статус команды (активна или неактивна)

  • Предпочтительный асинхронный канал связи команды (например, список рассылки, категория форума и т.д.)

  • Предпочтительный синхронный канал связи команды (например, канал IRC, комната Telegram и т.д.)

  • Система отслеживания задач команды

  • Встреча команды (предпочтительно ссылка на событие в Fedocal, либо фиксированный день и время)

  • Дополнительная информация, которую команда желает опубликовать в каталоге

Ожидается, что не все команды смогут дать ответы на все вышеперечисленные пункты. Они должны быть предоставлены, когда существуют.

Содержимое может храниться в репозитории council-docs, если у команды нет собственного репозитория документации. Если у команды есть свой репозиторий документации, содержимое может храниться в этом репозитории, чтобы его можно было использовать для отображения собственной документации команды. Это обеспечивает единый источник достоверных данных и предотвращает расхождение содержимого.

Обязанности

Команды несут ответственность за актуальность своих записей.

Представители DEI, Engineering и Mindshare в Fedora Council несут ответственность за то, чтобы команды, входящие в их область, поддерживали информацию в актуальном состоянии, и удаляли команды, которые не выглядят активными. Они не несут ответственности за предоставление информации. Представители могут делегировать части своей области по своему усмотрению. Проверки могут проводиться в любое время, но должны выполняться как минимум в дату ветвления для каждого релиза.

Механизм

Файлы с информацией о командах

Для каталога требуется файл, содержащий информацию о команде. Рекомендуемое соглашение об именовании — NAME_team_info.adoc, но подойдёт любое допустимое имя файла. Файл может храниться в собственном репозитории документации команды или в репозитории council-docs. Формат и структуру см. в примере шаблона.

Отображение каталога

Команды появятся в каталоге, если файл с информацией о команде включён в каталог {engineering,mindshare}/modules/ROOT/pages/index.adoc репозитория council-docs repo. После include файла с информацией страница index должна включать файл team_render.adoc, который определяет отображение.

Повторное использование данных на страницах команд

Команды могут включать свой файл NAME_team_info.adoc на свои страницы и затем использовать Fedora Council, The Fedora Council is our top-level community leadership and governance body. It is responsible for stewardship of the Fedora Project as a whole, and supports the health and growth of the Fedora community. и т.д. в любом месте страницы.

Want to help? Learn how to contribute to Fedora Docs ›