openSUSE:Документация openFATE
Содержание
Что такое запрос (Feature)?
По определению IEEE "возможность" - отличительная характеристика программы (например, производительность, переносимость или функционал)[1]
Проще говоря: "Возможность" для openSUSE - это запрос или предложение по добавлению какого- либо функционала, которого не было в предыдущем выпуске и который следует добавить в разрабатываемой версии. Будет великолепно, если запрос будет соответствовать желаниям большинства пользователей, а не только небольшой группы. Конечно, некоторые из этих запросов - вопрос ресурсов и индивидуальных вкусов - поэтому не огорчайтесь, если ваше предложение было отклонено. Чтобы избежать этого, старайтесь описывать свое предложение максимально понятным языком и всегда указывайте, какие преимущества для пользователя принесет реализация вашей идеи.
Не путайте улучшение программ и исправление ошибок. Ошибки это дефекты в существующем программном обеспечении. Это значит, что некоторые программы работают не так, как предполагалось/описывалось. Для сообщений об ошибках существует openSUSE Bugzilla. Сообщите туда об ошибке, чтобы ее можно было исправить. Вопрос об улучшениях решается похоже. Во- первых, что такое улучшения?
- Существуют программы, хорошо выполняющие свои задачи, но, возможно, им требуются некоторые изменения, чтобы выполнять поставленные задачи еще лучше и быстрее.
Создание запроса
Все кто имеет учетную запись openSUSE могут создать запрос в openFATE. Действуйте следующим образом:
- На сайте https://features.opensuse.org/, нажмите Create (Создать).
- Введите которткий Title (Заголовок), например Adjust Colors of the Default Desktop Wallpaper.
- Выберите Product (Продукт), например openSUSE-11.1
- Вы можете оставить нетронутым Приоритет (Priority).
- Добавьте краткое описание, например:
In GNOME, the color of the default desktop theme and the colors of the default wallpaper do not fit. Especially look at the title bar of the active window.
- В зависимости от того, о какой особенности Вы создаете запрос, add a Usecase and a Testcase by clicking on Add a Usecase and Add a Testcase.
- Наконец нажмите Save feature (Сохранить запрос).
Как работает OpenFATE?
Обычно создание запроса - первый шаг. Затем следует этап обсуждения. Всех, кто могут высказаться по поднятому вопросу, просят добавить свое мнение в комментариях. Это такие люди, как лидеры команд и разработчики, они должны уточнить технические детали и указать примерное время разработки. Заинтересовавшиеся пользователи могут подписаться под запросом, чтобы оставаться в курсе событий. Создавший запрос, знает обо всех этих ролях.
Фаза обсуждения и улучшения предложения необходима для того, чтобы люди, ответственные за разработку и продвижение программного продукта, могли составить мнение и вынести объективное решение по предложению. Их решение так же называется приоритетом.
Могут быть вынесены следующие решения:
- Desirable (Желательно)
- Функционал должен быть добавлен, если его реализация проста.
- Important (Важно)
- Продукт потеряет важную часть функционала без предложенного функционала .
- Mandatory (Обязательно)
- Отсутствие этого функционала вызовет накладки в работе продукта.
- Neutral (Нейтрально)
- Нет мнения по любой причине.
Существует поле, в котором показано актуальный статус предложения. Как только предложение создано, его статус NEW (Новое) или UNCONFIRMNED (Не подтверждено), до тех пор пока кто- нибудь не добавит к нему нескольких доверенных людей и не изменит статус на одно из состояний оценки. Период состояния оценки позволяет ответственным людям прийти к какому- либо решению. В итоге предложению выставляется статус "Candidate" (Кандидат), означающий принятие предложения в работу или "Rejected" (Отклонено), что означает отказ от дальнейшей работы над предложением.
Важно понимать, что приоритеты и статусы основаны на базе продуктов. Это значит, что если предложение отклонено для продукта А, оно может быть реализовано в продукте Б. Это одно из главных отличий между Fate и другими системами отслеживания запросов, таких как Bugzilla.
Насколько этот процесс является открытым?
Данные ядра Фичи, обсуждения и значения статуса - полностью открыты. Комментарии может добавить каждый зарегистрированный пользователь openSUSE.
Фичи включенные в openSUSE дифференцируются от других через специальные поля в данных Фичи под названием партнер. Эти поля автоматически установлены в openSUSE для openFATE.
Перемещение по базе предложений и создание комментариев
Поиск предложений
- На странице https://features.opensuse.org/, кликните Browse (Обзор).
- Уточните критерий запроса. Например, ключевое слово "color"(цвет) в поле Title/Description (Название/Описание). Или, если вам интересны все предложения, которые были реализованы для конкретного продукта, выберите, например, "openSUSE-11.2" в списке Product(s) (Продукт(ы)) и "done"(Выполнено) в поле Status (статус).
- Кликните Search (Поиск).
Если вы знаете ID номер предложения, введите его в правое верхнее поле и нажмите на символ поиска.
Как только вы нашли интересующее вас предложение, прочтите его и добавьте комментарий.
Добавление комментариев
Ниже обсуждения кликните "add comment" (Добавить комментарий), чтобы появилось поле для ввода текста. Для сохранения своего комментария, кликните "Add comment" (Добавить комментарий) под полем для ввода текста. Наконец, кликните Save feature (сохранить предложение), чтобы добавить ваш комментарий в базу предложений.
Вы можете отвечать на чужие комментарии, кликая на кнопку reply (ответить).
Голосование за предложение
Виджет голосования находится в правой верхней части окна с предложением. В нем показано количество набранных голосов, а через пункт "toggle statistics" (показать статистику) можно посмотреть историю голосования. Чтобы добавить свой голос, пожалуйста зайдите со своей учетной записи. При наведении курсора на виджет голосования, вы увидите три варианта голосования: "down", "neutral" и "up". Используйте механизм голосования, чтобы отметить наиболее заинтересовавшие вас предложения и не используйте для этих целей комментарии, иначе это затрудняет дальнейшие просмотр и обработку предложения.
Информирование об изменениях
Чтобы пользователь мог оставаться в курсе всех изменений или отслеживать конкретные предложения, мы предоставляем различные сервисы.
- Сервис уведомлений Hermes
- Какое- то предложение вас заинтересовало. Как эффективно отслеживать ход обсуждения и добавлять комментарии, когда это необходимо? Наш сервис уведомлений Hermes является лучшим решением для этих целей. В нем вы можете подписаться на уведомления и указать, как часто вы хотите их получать.
- RSS лента
- Просто подпишитесь на нашу RSS ленту и вы всегда будете в курсе всех произошедших изменений.
- Служба почтовой рассылки
- Тем, кого интересует абсолютно все, следует подписаться на рассылку feature mailinglist, в которой описываются все изменения произошедшие в openFATE.
Детальное описание атрибутов запроса
Каждое предложение описывается рядом атрибутов. Что значит каждый из атрибутов и как они должны быть заполнены, описано ниже.
Title (Заголовок) Короткое, в одну строчку, описание предложения. (Например: "Improved argument handling for zypper")
Tags (Теги) Теги- ключевые слова, ассоциирующиеся с предложением (смотри так же http://en.wikipedia.org/wiki/Tag_(metadata)). Облако тегов создается из всех используемых тегов. Чем чаще используется тег, тем он крупнее в облаке.
Products (Продукты) Один или несколько продуктов, для которых сделано предложение. Каждый продукт отслеживается отдельно, поэтому, например, ваше предложение могло быть отклонено для openSUSE 11.2, но реализовано для версии 11.3.
Priority (Приоритет) Определяет приоритет, который это предложение имеет для определенного агента.
- Mandatory (Обязательно): Это предложение необходимо реализовать. Выпуск конечного продукта без этого невозможен.
- Important (Важно): Предложение должно быть реализовано, если это возможно.
- Desirable (Желательно): Данное предложение способно сделать конечный продукт лучше, но его реализация может быть отложена до будущих выпусков, или отменена совсем.
- Neutral (Нейтрально): У данного предложения низкий приоритет.
Имейте ввиду, что выставление предложению высокого приоритета не гарантирует его реализации в готовящейся к выходу версии.
Агенты (Actors)
- Requester (Запрашивающая сторона): Контактное лицо для openSUSE, в случае когда необходимо уточнить детали предложения. При создании нового предложения, запрашивающий автоматически становится аутентифицированным пользователем.
- Interested Person (Заинтересованное лицо): Добавьте себя к списку "Заинтересованных лиц", когда вы хотите, чтобы предложение было доступно для просмотра в вашем списке наблюдения.
- Developer (Разработчик): Разработчик- лицо, ответственное за реализацию предложения. Этим лицом может быть как сотрудник Novell, так и просто член сообщества.
Description (Описание)
Опишите суть предложения достаточно ясно, чтобы цель запроса была понятна без каких- либо дополнительных сведений из контекста.
Если возможно, добавьте короткий use-case сценарий.
Не используйте здесь многостраничные спецификации, примеры кода или патчи для ядра. Для добавления подобной информации, лучше указывать URL ссылки на соответствующие ресурсы.
Пожалуйста, не забудьте сообщить, если вы знаете о готовых вариантах решения поднятого вопроса, или можете самостоятельно предоставить необходимый патч.
Преимущества для участников
Какие преимущества получают участники, заинтересованные в реализации предложения?
Элементы Richtext
Поля описания, комментариев и диаграмм могут быть оформлены с помощью элементов richtext. openFATE поддерживает следующие элементы richtext:
<p>...</p> Новый абзац
<pre>...</pre> Предварительно форматированный текст. Весь текст будет выведен так, как он набран.
<h3>...</h3> Заголовок
<ul>...</ul> Маркированный (неупорядоченный) список. Должен содержать элементы <li>...</li>
<ol>...</ol> Нумерованный список. Так же должен содержать элементы <li>...</li>
<a href="http://host.domain/path/">...</a> Гиперссылка на другой ресурс в интернете
<b>...</b> Жирный текст
<em>...</em> Курсивный текст
<tt>...</tt> Шрифт как на пишущей машинке