.. _feature-tracking: Feature Tracking ################# For feature tracking we use Github labels to classify new features and enhancements. The following is the description of each category: Enhancement Changes to existing features that are not considered a bug and would not block a release. This is an incremental enhancement to a feature that already exists in Zephyr. Feature request A request for the implementation or inclusion of a new unit of functionality that is not part of any release plans yet, that has not been vetted, and needs further discussion and details. Feature A committed and planned unit of functionality with a detailed design and implementation proposal and an owner. Features must go through an RFC process and must be vetted and discussed in the TSC before a target milestone is set. Hardware Support A request or plan to port an existing feature or enhancement to a particular hardware platform. This ranges from porting Zephyr itself to a new architecture, SoC or board to adding an implementation of a peripheral driver API for an existing hardware platform. Meta A label to group other GitHub issues that are part of a single feature or unit of work. The following workflow should be used to process features:. This is the formal way for asking for a new feature in Zephyr and indicating its importance to the project. Often, the requester may have a readiness and willingness to drive implementation of the feature in an upcoming release, and should assign the request to themselves. If not though, an owner will be assigned after evaluation by the TSC. A feature request can also have a companion RFC with more details on the feature and a proposed design or implementation. - Label new features requests as ``feature-request`` - The TSC discusses new ``feature-request`` items regularly and triages them. Items are examined for similarity with existing features, how they fit with the project goals and other timeline considerations. The priority is determined as follows: - High = Next milestone - Medium = As soon as possible - Low = Best effort - After the initial discussion and triaging, the label is moved from ``feature-request`` to ``feature`` with the target milestone and an assignee. All items marked as ``feature-request`` are non-binding and those without an assignee are open for grabs, meaning that they can be picked up and implemented by any project member or the community. You should contact an assigned owner if you'd like to discuss or contribute to that feature's implementation Roadmap and Release Plans ************************* Project roadmaps and release plans are both important tools for the project, but they have very different purposes and should not be confused. A project roadmap communicates the high-level overview of a project's strategy, while a release plan is a tactical document designed to capture and track the features planned for upcoming releases. - The project roadmap communicates the why; a release plan details the what - A release plan spans only a few months; a product roadmap might cover a year or more Project Roadmap ================ The project roadmap should serve as a high-level, visual summary of the project's strategic objectives and expectations. If built properly, the roadmap can be a valuable tool for several reasons. It can help the project present its plan in a compelling way to existing and new stakeholders, to help recruit new members and it can be a helpful resource the team and community can refer to throughout the project's development, to ensure they are still executing according to plan. As such, the roadmap should contain only strategic-level details, major project themes, epics, and goals. Release Plans ============== The release plan comes into play when the project roadmap's high-level strategy is translated into an actionable plan built on specific features, enhancements, and fixes that need to go into a specific release or milestone. The release plan communicates those features and enhancements slated for your project' next release (or the next few releases). So it acts as more of a project plan, breaking the big ideas down into smaller projects the community and main stakeholders of the project can make progress on. Items labeled as ``features`` are short or long term release items that shall have an assignee and a milestone set.