From e56e957f96cb1b197b3f446a8b86f39d8e76c058 Mon Sep 17 00:00:00 2001 From: Joostlek Date: Tue, 23 Sep 2025 23:28:50 +0200 Subject: [PATCH 1/2] Add page to explain the roles in developing --- docs/development_roles.md | 23 +++++++++++++++++++++++ sidebars.js | 1 + 2 files changed, 24 insertions(+) create mode 100644 docs/development_roles.md diff --git a/docs/development_roles.md b/docs/development_roles.md new file mode 100644 index 00000000000..74b17908d42 --- /dev/null +++ b/docs/development_roles.md @@ -0,0 +1,23 @@ +--- +title: "Roles in development" +--- + +During development of Home Assistant integrations, you will come across different roles that are involved in the process. This document explains these roles and their responsibilities. + +## Core members + +Core members are contributors with write access to the Home Assistant Core repository. +They have the ability to review and merge pull requests, manage issues, and maintain the overall quality of the codebase. +Core members are responsible for ensuring that contributions adhere to the project's guidelines and standards. + +## Integration owners + +Formerly known as "codeowners", integration owners are core members who have taken on the responsibility of maintaining specific integrations within Home Assistant. +Comments and concerns raised by integration owners are held in high regard, as they possess in-depth knowledge of the integration they oversee. +Integration owners are mentioned in every pull request that changes the code of their integration, and in every issue that is opened for their integration. + +## Core team + +The core team is a group of developers responsible for the overall direction and management of the Home Assistant Core project. +They are employed by The Open Home Foundation. +The core team generally meets every week to discuss pull requests and architectural proposals. \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index eb1ab98b223..7db20ae524a 100644 --- a/sidebars.js +++ b/sidebars.js @@ -93,6 +93,7 @@ module.exports = { ], Core: [ "development_index", + "development_roles", { type: "category", label: "Architecture", From 1f6139c0e999068b80e3ab2439df6d6ecf356f4a Mon Sep 17 00:00:00 2001 From: Joostlek Date: Mon, 13 Oct 2025 16:14:52 +0200 Subject: [PATCH 2/2] Add page to explain the roles in developing --- docs/development_roles.md | 23 ----------------------- docs/overview/roles.md | 29 +++++++++++++++++++++++++++++ sidebars.js | 2 +- 3 files changed, 30 insertions(+), 24 deletions(-) delete mode 100644 docs/development_roles.md create mode 100644 docs/overview/roles.md diff --git a/docs/development_roles.md b/docs/development_roles.md deleted file mode 100644 index 74b17908d42..00000000000 --- a/docs/development_roles.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: "Roles in development" ---- - -During development of Home Assistant integrations, you will come across different roles that are involved in the process. This document explains these roles and their responsibilities. - -## Core members - -Core members are contributors with write access to the Home Assistant Core repository. -They have the ability to review and merge pull requests, manage issues, and maintain the overall quality of the codebase. -Core members are responsible for ensuring that contributions adhere to the project's guidelines and standards. - -## Integration owners - -Formerly known as "codeowners", integration owners are core members who have taken on the responsibility of maintaining specific integrations within Home Assistant. -Comments and concerns raised by integration owners are held in high regard, as they possess in-depth knowledge of the integration they oversee. -Integration owners are mentioned in every pull request that changes the code of their integration, and in every issue that is opened for their integration. - -## Core team - -The core team is a group of developers responsible for the overall direction and management of the Home Assistant Core project. -They are employed by The Open Home Foundation. -The core team generally meets every week to discuss pull requests and architectural proposals. \ No newline at end of file diff --git a/docs/overview/roles.md b/docs/overview/roles.md new file mode 100644 index 00000000000..515cb0bf2ed --- /dev/null +++ b/docs/overview/roles.md @@ -0,0 +1,29 @@ +--- +title: "Roles in development" +--- + +During development of parts of Home Assistant, you will come across different roles that are involved in the process. This document explains these roles and their responsibilities. + +## Core + +### Core members + +Core members are contributors with write access to the Home Assistant Core repository. +They have the ability to review and merge pull requests, manage issues, and maintain the overall quality of the codebase. +Core members are responsible for ensuring that contributions adhere to the project's guidelines and standards. + +The list of core members can be found [on GitHub](https://github.com/orgs/home-assistant/teams/developers). + +### Integration owners + +Integration owners are contributors or core members who have taken on the responsibility of maintaining specific integrations within Home Assistant. +Comments and concerns raised by integration owners are held in high regard, as they possess in-depth knowledge of the integration they oversee. +Integration owners are notified in every pull request that changes the code of their integration, and in every issue that is opened for their integration. + +### Core team + +The core team is a group of developers responsible for the overall direction and management of the Home Assistant Core project. +They are employed by the Open Home Foundation. +The core team generally meets every week to discuss pull requests and architectural proposals. + +The list of members in the core team can be found [on GitHub](https://github.com/orgs/home-assistant/teams/core). \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index 7db20ae524a..c1d0ecc745f 100644 --- a/sidebars.js +++ b/sidebars.js @@ -29,6 +29,7 @@ module.exports = { ], Overview: [ "architecture_index", + "overview/roles", "setup_devcontainer_environment" ], Frontend: [ @@ -93,7 +94,6 @@ module.exports = { ], Core: [ "development_index", - "development_roles", { type: "category", label: "Architecture",