From d07cb16e4d2a6cbc1b4f50e572df1ed8d4217cb8 Mon Sep 17 00:00:00 2001 From: John Halley Gotway Date: Wed, 30 Nov 2022 17:26:26 -0700 Subject: [PATCH 01/10] Per #1885, add instructions for creating development projects. --- docs/Contributors_Guide/github_workflow.rst | 117 ++++++++++++++++++++ 1 file changed, 117 insertions(+) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index 3744be95b6..77e271ad85 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -23,6 +23,123 @@ then the develop branch is used to create a main_vx.y release of METplus, which includes data tarballs for use in running use cases. +GitHub Projects to manage development +------------------------------------- + +Software development for official METplus releases is organized into development cycles. +While the length a development cycle can vary widely, they are nominally 6 weeks long. +GitHub issues and pull requests assigned to each cycle are either completed during the +time window for that cycle or re-assigned to a future development cycle. + + +Each development cycle culminates in the creation of a software release. The +:ref:`releaseCycleStages` section describes the various types of software releases +(development, official, or bugfix). Each development cycle culminates in a beta release, +a release candidate, or the official release. Generally, a **beta** development cycle results +in a **beta** development release while an **rc** development cycle results in an **rc** +development release. + + +The METplus team uses GitHub projects to manage these development cycles as well as the support +of official releases. In earlier versions, each development cycle was managed by an individual +GitHub project but more recent versions use a single GitHub project to manage all of the +development cycles. Listed below are instructions for creating a single GitHub project to +manage development toward a new official release. Note that sufficient permissions in GitHub +are required to perform the following steps. + + +1. Create a new project. + + - From the `DTCenter GitHub Projects `_ + page, select the **New project** button. + - In the **Select a template** popup window, select the **Project templates: Feature** + option, and click the **Create** button. + +2. Update the project settings. + + - Click on the three dots to the right of the project name to see **More options** + and select **Settings**. Modify these settings as follows. + + - Project name: The default project name is **@UserNames's feature**. Rename it as + **{METplus Component}-{Target Version Number} Development** (e.g. **METplus-5.1.0 Development**). + + - Add a description: Add **Development toward {METplus Component} version {Target Version Number}.** + + - README: Add additional details as needed to the **README** section. Projects managing development + for multiple repositories, such as METplus-Analysis, should list the target version number for + each repository. Click **Save**. + + - Scroll down to the **Danger zone** and change **Visibilty** from its default value of **Private** + to **Public**. + + - Select **Manage access** on the left hand navigation bar. + + - By default, the project creator has **Admin** access. + + - Add **Admin** access for any user with that level of access to any one + of the repositories managed by this project. + + - Add **Write** access for the **METplus** group. + + - Select the **Custom fields** section in the left hand navigation bar + + - Select **Status** and retain the default list of options, but delete the **New** option by clicking + the **X** to its right. + + - Select **Iteration** and modify the **Field name** to be **Cycle**. Delete any existing cycles. + Under **More options** select a **Start on* date and set the default **Duration** as 6 weeks. + Click the **Add** and **Add iteration** buttons to create 5 cycles, each with the default duration + of 6 weeks. Modify the cycle names to be **Beta1**, **Beta2**, and so on. Click **Save changes**. + + - Select **Estimate** and click the three dots to the right and **Delete field**. + + - Click the backward arrow to return to the project page. + +3. Create project views. + + - Each **view** appears as a tab on the project page. Create a new view as described below. + + - Select the **+ New view** option. + + - Click on the view name to modify it, rename it as **All Cycles**, and hit **Enter**. + + - Click on the downward arrow and, under **Configuration**, select the **Fields** option. Enable + the options for **Title**, **Repository**, **Assignees**, **Cycle**, **Status**, + **Linked Pull Request**, and **Reviewers**. Drag and drop the items to reorder them as listed above. + + - In the resulting view, click the three dots in the **Status** column. Select the **Sort descending** + and **Group by values** options. + + - The blue dot on the downward error for this tab indicates that there are unsaved changes. + Select the **Save changes** option. + + - Click on the downward arrow and select **Duplicate View**. Do this 7 times and name/refine these views as follows. + + - View name **All Required** shows all items labelled as *REQUIRED* for the development or official release. + Click on the 3 horizontal bars and define the filtering criteria as + **label:"required: FOR OFFICIAL RELEASE","required: FOR DEVELOPMENT RELEASE" is:open**. Click **Save Changes**. + + - View name **Beta1** to **Beta5** shows items for each individual development cycle. + Click on the 3 horizontal bars and define the filtering criteria as **cycle:Beta1**, **cycle:Beta2**, + and so on. Click **Save Changes**. + + - View name **Closed Issues** shows issues that have been closed across all development cycles. + Click on the 3 horizontal bars and define the filtering criteria as **is:closed is:issue**. + Click on the 3 dots in the **Cycle** column and select **Group by values**. Click **Save Changes**. + + - Delete any other views created by default by clicking the downward arrow next to the view name and + selecting **Delete view**. + +4. Refine the project settings, development cycle dates, and views, as needed, based on the preferences + of the development team. + +5. Link the new project to each repository. + + - Navigate to the project page for each repository managed by this project + (e.g. `METplus Projects`_). + + - Click the **Link a project** button and find/select the newly created project. + Sequence of Events - Contributing Code -------------------------------------- From 8610b3f725b4770fab4344bfa4c2a9b0ccce97b7 Mon Sep 17 00:00:00 2001 From: John Halley Gotway Date: Wed, 30 Nov 2022 17:27:06 -0700 Subject: [PATCH 02/10] Per #1885, add instructions for creating development projects. --- docs/Contributors_Guide/github_workflow.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index 77e271ad85..f4e1201493 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -138,7 +138,7 @@ are required to perform the following steps. - Navigate to the project page for each repository managed by this project (e.g. `METplus Projects`_). - - Click the **Link a project** button and find/select the newly created project. + - Click the **Link a project** button and find/select this newly created project. Sequence of Events - Contributing Code -------------------------------------- From 896c915393676da1a534547ea13b5f84c0229e5c Mon Sep 17 00:00:00 2001 From: John Halley Gotway Date: Wed, 30 Nov 2022 17:35:38 -0700 Subject: [PATCH 03/10] Per #1885, insert missing space. --- docs/Contributors_Guide/github_workflow.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index f4e1201493..48a581698e 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -136,7 +136,7 @@ are required to perform the following steps. 5. Link the new project to each repository. - Navigate to the project page for each repository managed by this project - (e.g. `METplus Projects`_). + (e.g. `METplus Projects `_). - Click the **Link a project** button and find/select this newly created project. From 5dc34692bc4ea388c98dda035dce52e2023140a1 Mon Sep 17 00:00:00 2001 From: John Halley Gotway Date: Wed, 30 Nov 2022 17:58:42 -0700 Subject: [PATCH 04/10] Per #1885, add detail about project workflows. --- docs/Contributors_Guide/github_workflow.rst | 29 ++++++++++++++++----- 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index 48a581698e..a7c9f96860 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -48,17 +48,17 @@ manage development toward a new official release. Note that sufficient permissi are required to perform the following steps. -1. Create a new project. +1. Create a **new project**. - From the `DTCenter GitHub Projects `_ page, select the **New project** button. - In the **Select a template** popup window, select the **Project templates: Feature** option, and click the **Create** button. -2. Update the project settings. +2. Update the project **settings**. - Click on the three dots to the right of the project name to see **More options** - and select **Settings**. Modify these settings as follows. + and select **Settings**. Modify these settings as follows. - Project name: The default project name is **@UserNames's feature**. Rename it as **{METplus Component}-{Target Version Number} Development** (e.g. **METplus-5.1.0 Development**). @@ -95,7 +95,24 @@ are required to perform the following steps. - Click the backward arrow to return to the project page. -3. Create project views. +3. Update the project **workflows**. + + - Click on the three dots to the right of the project name to see **More options** + and select **Workflows**. Modify these settings as follows. + + - Enable the **Item added to project** workflow and set the status to **Backlog**. + + - Enable the **Item reopened** workflow and set the status to **In progress**. + + - Enable the **Item closed** workflow and set the status to **Done**. + + - Enable the **Pull request merged** workflow and set the status to **Done**. + + - Leave all other workflows disabled. + + - Click the backward arrow to return to the project page. + +4. Create project views. - Each **view** appears as a tab on the project page. Create a new view as described below. @@ -130,10 +147,10 @@ are required to perform the following steps. - Delete any other views created by default by clicking the downward arrow next to the view name and selecting **Delete view**. -4. Refine the project settings, development cycle dates, and views, as needed, based on the preferences +5. Refine the project settings, development cycle dates, and views, as needed, based on the preferences of the development team. -5. Link the new project to each repository. +6. Link the new project to each repository. - Navigate to the project page for each repository managed by this project (e.g. `METplus Projects `_). From 2a6af0d0eac248d5200bfcd82f93311afc2674d1 Mon Sep 17 00:00:00 2001 From: John Halley Gotway Date: Wed, 30 Nov 2022 18:00:27 -0700 Subject: [PATCH 05/10] Per #1885, more bolding. --- docs/Contributors_Guide/github_workflow.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index a7c9f96860..1c6e904217 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -48,14 +48,14 @@ manage development toward a new official release. Note that sufficient permissi are required to perform the following steps. -1. Create a **new project**. +1. Create a **New project**. - From the `DTCenter GitHub Projects `_ page, select the **New project** button. - In the **Select a template** popup window, select the **Project templates: Feature** option, and click the **Create** button. -2. Update the project **settings**. +2. Update the project **Settings**. - Click on the three dots to the right of the project name to see **More options** and select **Settings**. Modify these settings as follows. @@ -95,7 +95,7 @@ are required to perform the following steps. - Click the backward arrow to return to the project page. -3. Update the project **workflows**. +3. Update the project **Workflows**. - Click on the three dots to the right of the project name to see **More options** and select **Workflows**. Modify these settings as follows. @@ -112,9 +112,9 @@ are required to perform the following steps. - Click the backward arrow to return to the project page. -4. Create project views. +4. Create project **Views**. - - Each **view** appears as a tab on the project page. Create a new view as described below. + - Each view appears as a tab on the project page. Create a new view as described below. - Select the **+ New view** option. From b1c8d4bfa15ae332c7b924fa5610a5a90f6cf78f Mon Sep 17 00:00:00 2001 From: John Halley Gotway Date: Thu, 1 Dec 2022 12:06:22 -0700 Subject: [PATCH 06/10] Per #1885, add section about support projects. --- docs/Contributors_Guide/github_workflow.rst | 145 ++++++++++++++++++-- 1 file changed, 134 insertions(+), 11 deletions(-) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index 1c6e904217..e438075760 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -22,6 +22,7 @@ develop branch. When a release candidate for METplus has been determined, then the develop branch is used to create a main_vx.y release of METplus, which includes data tarballs for use in running use cases. +.. _wo-development-project: GitHub Projects to manage development ------------------------------------- @@ -52,6 +53,7 @@ are required to perform the following steps. - From the `DTCenter GitHub Projects `_ page, select the **New project** button. + - In the **Select a template** popup window, select the **Project templates: Feature** option, and click the **Create** button. @@ -67,7 +69,7 @@ are required to perform the following steps. - README: Add additional details as needed to the **README** section. Projects managing development for multiple repositories, such as METplus-Analysis, should list the target version number for - each repository. Click **Save**. + each repository. - Scroll down to the **Danger zone** and change **Visibilty** from its default value of **Private** to **Public**. @@ -81,10 +83,10 @@ are required to perform the following steps. - Add **Write** access for the **METplus** group. - - Select the **Custom fields** section in the left hand navigation bar + - Locate the **Custom fields** section in the left hand navigation bar - - Select **Status** and retain the default list of options, but delete the **New** option by clicking - the **X** to its right. + - Select **Status** and retain the default list of options, but delete the + **New** option by clicking the **X** to its right. - Select **Iteration** and modify the **Field name** to be **Cycle**. Delete any existing cycles. Under **More options** select a **Start on* date and set the default **Duration** as 6 weeks. @@ -93,7 +95,7 @@ are required to perform the following steps. - Select **Estimate** and click the three dots to the right and **Delete field**. - - Click the backward arrow to return to the project page. + - Click the back arrow to return to the project page. 3. Update the project **Workflows**. @@ -110,7 +112,7 @@ are required to perform the following steps. - Leave all other workflows disabled. - - Click the backward arrow to return to the project page. + - Click the back arrow to return to the project page. 4. Create project **Views**. @@ -120,17 +122,17 @@ are required to perform the following steps. - Click on the view name to modify it, rename it as **All Cycles**, and hit **Enter**. - - Click on the downward arrow and, under **Configuration**, select the **Fields** option. Enable + - Click on the down arrow and, under **Configuration**, select the **Fields** option. Enable the options for **Title**, **Repository**, **Assignees**, **Cycle**, **Status**, **Linked Pull Request**, and **Reviewers**. Drag and drop the items to reorder them as listed above. - In the resulting view, click the three dots in the **Status** column. Select the **Sort descending** and **Group by values** options. - - The blue dot on the downward error for this tab indicates that there are unsaved changes. + - The blue dot on the down arrow for this tab indicates that there are unsaved changes. Select the **Save changes** option. - - Click on the downward arrow and select **Duplicate View**. Do this 7 times and name/refine these views as follows. + - Click on the down arrow and select **Duplicate View**. Do this 7 times and name/refine these views as follows. - View name **All Required** shows all items labelled as *REQUIRED* for the development or official release. Click on the 3 horizontal bars and define the filtering criteria as @@ -144,7 +146,7 @@ are required to perform the following steps. Click on the 3 horizontal bars and define the filtering criteria as **is:closed is:issue**. Click on the 3 dots in the **Cycle** column and select **Group by values**. Click **Save Changes**. - - Delete any other views created by default by clicking the downward arrow next to the view name and + - Delete any other views created by default by clicking the down arrow next to the view name and selecting **Delete view**. 5. Refine the project settings, development cycle dates, and views, as needed, based on the preferences @@ -153,10 +155,131 @@ are required to perform the following steps. 6. Link the new project to each repository. - Navigate to the project page for each repository managed by this project - (e.g. `METplus Projects `_). + (e.g. `METplus Projects `_). - Click the **Link a project** button and find/select this newly created project. +.. _wo-support-project: + +GitHub Projects to manage support +--------------------------------- + +Support for coordinated METplus releases is managed using a *single* GitHub project +for all components. Bugfix issues and the corresponding pull request fixes are added +to that support project. Each fix is assigned to the current bugfix milestone of +the corresponding source code repository. + + +The :ref:`releaseCycleStages` section describes the various types of software releases +(development, official, or bugfix). The GitHub support project contains issues and +pull requests that apply only to bugfix releases. + + +Listed below are instructions for creating a GitHub project to manage support after an +official coordinated METplus release. Note that sufficient permissions in GitHub are +required to perform the following steps. + + +1. Create a **New project**. + + - From the `DTCenter GitHub Projects `_ + page, select the **New project** button. + + - In the **Select a template** popup window, select the **Project templates: Feature** + option, and click the **Create** button. + +2. Update the project **Settings**. + + - Click on the three dots to the right of the project name to see **More options** + and select **Settings**. Modify these settings as follows. + + - Project name: The default project name is **@UserNames's feature**. Rename it as + **METplus Version {X.Y} Support** (e.g. **METplus Version 5.0 Support**). + + - Add a description: Add **Issues related to support for the METplus {X.Y} + coordinated release.** + + - README: List the {X.Y} version number for each METplus component contained within + the coordinated release. + + - Scroll down to the **Danger zone** and change **Visibilty** from its default value + of **Private** to **Public**. + + - Select **Manage access** on the left hand navigation bar. + + - By default, the project creator has **Admin** access. + + - Add **Admin** access for at least 2 other users with that level of access on one + of the METplus component repositories. + + - Add **Write** access for the **METplus** group. + + - Locate the **Custom fields** section in the left hand navigation bar + + - Select **Status** and retain the default list of options, but delete the + **New** option by clicking the **X** to its right. + + - For **Iteration** and **Estimate**, click the 3 dots to the right of the + **Field name** and **Delete field**. + + - Click the back arrow to return to the project page. + +3. Update the project **Workflows**. + + - Click on the three dots to the right of the project name to see **More options** + and select **Workflows**. Modify these settings as follows. + + - Enable the **Item added to project** workflow and set the status to **Backlog**. + + - Enable the **Item reopened** workflow and set the status to **In progress**. + + - Enable the **Item closed** workflow and set the status to **Done**. + + - Enable the **Pull request merged** workflow and set the status to **Done**. + + - Leave all other workflows disabled. + + - Click the back arrow to return to the project page. + +4. Create project **Views**. + + - Each view appears as a tab on the project page. Create a new view as described below. + + - Select the **+ New view** option. + + - Click on the view name to modify it, rename it as **All Milestones**, and hit **Enter**. + + - Click on the down arrow and, under **Configuration**, select the **Fields** option. Enable + the options for **Title**, **Repository**, **Assignees**, **Milestone**, **Status**, + **Linked Pull Request**, and **Reviewers**. Drag and drop the items to reorder them + as listed above. + + - In the resulting view, click the three dots in the **Milestone** column. Select the + **Sort descending** and **Group by values** options. + + - The blue dot on the down arrow for this tab indicates that there are unsaved changes. + Select the **Save changes** option. + + - Delete any other views created by default by clicking the down arrow next to the view + name and selecting **Delete view**. + +5. Refine the project settings and views, as needed, based on the preferences of the support team. + +6. Link the new project to each repository. + + - Navigate to the project page for each METplus component repository: + + - `METplus `_, + `MET `_, + `METviewer `_, + `METexpress `_, + `METplotpy `_, + `METcalcpy `_, + `METdataio `_ + + - Click the **Link a project** button and find/select this newly created support project. + + Sequence of Events - Contributing Code -------------------------------------- From a37ffdac60b8af9aec2e09a8344c9a84fdc4e35f Mon Sep 17 00:00:00 2001 From: John Halley Gotway Date: Thu, 1 Dec 2022 12:23:15 -0700 Subject: [PATCH 07/10] Per #1885, update Release guide to link to the contributors guide details. --- docs/Contributors_Guide/github_workflow.rst | 16 +++++++++++----- .../finalize_release_on_github_development.rst | 7 +++---- .../finalize_release_on_github_official.rst | 8 ++++++-- .../update_release_notes_bugfix.rst | 14 +++----------- .../update_release_notes_development.rst | 18 +++++------------- .../update_release_notes_official.rst | 18 +++++------------- 6 files changed, 33 insertions(+), 48 deletions(-) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index e438075760..fd2250a19d 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -89,7 +89,7 @@ are required to perform the following steps. **New** option by clicking the **X** to its right. - Select **Iteration** and modify the **Field name** to be **Cycle**. Delete any existing cycles. - Under **More options** select a **Start on* date and set the default **Duration** as 6 weeks. + Under **More options** select a **Start on** date and set the default **Duration** as 6 weeks. Click the **Add** and **Add iteration** buttons to create 5 cycles, each with the default duration of 6 weeks. Modify the cycle names to be **Beta1**, **Beta2**, and so on. Click **Save changes**. @@ -194,12 +194,12 @@ required to perform the following steps. and select **Settings**. Modify these settings as follows. - Project name: The default project name is **@UserNames's feature**. Rename it as - **METplus Version {X.Y} Support** (e.g. **METplus Version 5.0 Support**). + **METplus Version X.Y Support** (e.g. **METplus Version 5.0 Support**). - - Add a description: Add **Issues related to support for the METplus {X.Y} + - Add a description: Add **Issues related to support for the METplus X.Y coordinated release.** - - README: List the {X.Y} version number for each METplus component contained within + - README: List the X.Y version number for each METplus component contained within the coordinated release. - Scroll down to the **Danger zone** and change **Visibilty** from its default value @@ -260,6 +260,13 @@ required to perform the following steps. - The blue dot on the down arrow for this tab indicates that there are unsaved changes. Select the **Save changes** option. + - Click on the down arrow and select **Duplicate View**. Name/refine this views as follows. + + - View name **Closed Issues** shows issues that have been closed across all bugfix + milestones. Click on the 3 horizontal bars and define the filtering criteria as + **is:closed is:issue**. Click on the 3 dots in the **Milestone** column and select + **Group by values**. Click **Save Changes**. + - Delete any other views created by default by clicking the down arrow next to the view name and selecting **Delete view**. @@ -279,7 +286,6 @@ required to perform the following steps. - Click the **Link a project** button and find/select this newly created support project. - Sequence of Events - Contributing Code -------------------------------------- diff --git a/docs/Release_Guide/release_steps/finalize_release_on_github_development.rst b/docs/Release_Guide/release_steps/finalize_release_on_github_development.rst index e33c60bc49..194b758c04 100644 --- a/docs/Release_Guide/release_steps/finalize_release_on_github_development.rst +++ b/docs/Release_Guide/release_steps/finalize_release_on_github_development.rst @@ -2,7 +2,6 @@ Finalize Release on GitHub -------------------------- * Close the GitHub issue for creating this development release. -* Edit the development project name for the current release to indicate the actual release date. -* Review the remaining development projects, and if neccessary, add new ones. -* If necessary, reassign any remaining issues from the current development project to the next one. -* Close the development project for the current release. +* Edit the date of the development cycle for the current release to indicate the actual release date. +* Review the remaining development cycles, and if neccessary, adjust dates and/or add new cycles. +* If necessary, reassign any remaining issues for the current development cycle to the next one. diff --git a/docs/Release_Guide/release_steps/finalize_release_on_github_official.rst b/docs/Release_Guide/release_steps/finalize_release_on_github_official.rst index 45123c695d..8ce6b0db5c 100644 --- a/docs/Release_Guide/release_steps/finalize_release_on_github_official.rst +++ b/docs/Release_Guide/release_steps/finalize_release_on_github_official.rst @@ -19,9 +19,13 @@ Finalize Release on GitHub * Update projects: - * Confirm that all existing development projects for the current milestone are closed. + * Close the existing development project for the current milestone. - * If necessary, create development projects for the next milestone (e.g. |projectRepo|-X.Y.Z-beta1, beta2, beta3). + * If necessary, see :ref:`wo-support-project` to create a support project for the current + METplus coordinated release. + + * If necessary, see :ref:`wo-development-project` to create a development project for the + next milestone. * Update branches: diff --git a/docs/Release_Guide/release_steps/update_release_notes_bugfix.rst b/docs/Release_Guide/release_steps/update_release_notes_bugfix.rst index 70456f029e..7fe434deae 100644 --- a/docs/Release_Guide/release_steps/update_release_notes_bugfix.rst +++ b/docs/Release_Guide/release_steps/update_release_notes_bugfix.rst @@ -6,21 +6,13 @@ release. Open the following URL in a browser: .. parsed-literal:: - https://github.com/orgs/dtcenter/projects?type=beta + https://github.com/orgs/dtcenter/projects * Click on the project that corresponds to support for the release, i.e. METplus Version X.Y Support -* Navigate to the "Closed Issues" tab. - **If this tab does not exist**, follow these instructions to create it: - - * Click on "+ New view" button on the far right side of the view tabs - * Click on "View " (where is an integer) and rename it to - "Closed Issues" - * Click on the down arrow next to the newly created view - * Click on "Search or filter this view" - * Enter the following info into the filter bar: **is:closed is:issue** - * Click on the down arrow next to the view and click "Save changes" +* Navigate to the "Closed Issues" tab. If this tab does not exist, + see :ref:`wo-support-project` to create it. * Find the closed issues with dtcenter/|projectRepo| in the Repository column that have been added since the last bugfix release for |projectRepo|. diff --git a/docs/Release_Guide/release_steps/update_release_notes_development.rst b/docs/Release_Guide/release_steps/update_release_notes_development.rst index 8cc4021a6c..72c2d1ce25 100644 --- a/docs/Release_Guide/release_steps/update_release_notes_development.rst +++ b/docs/Release_Guide/release_steps/update_release_notes_development.rst @@ -6,21 +6,13 @@ release. Open the following URL in a browser: .. parsed-literal:: - https://github.com/orgs/dtcenter/projects?type=beta + https://github.com/orgs/dtcenter/projects * Click on the project that corresponds to this release, i.e. - |projectRepo|-X.Y.Z-betaN - -* Navigate to the "Closed Issues" tab. - **If this tab does not exist**, follow these instructions to create it: - - * Click on "+ New view" button on the far right side of the view tabs - * Click on "View " (where is an integer) and rename it to - "Closed Issues" - * Click on the down arrow next to the newly created view - * Click on "Search or filter this view" - * Enter the following info into the filter bar: **is:closed is:issue** - * Click on the down arrow next to the view and click "Save changes" + |projectRepo|-X.Y.Z Development + +* Navigate to the "Closed Issues" tab. If this tab does not exist, + see :ref:`wo-development-project` to create it. * Update the release-notes.rst file found in the User's Guide directory. diff --git a/docs/Release_Guide/release_steps/update_release_notes_official.rst b/docs/Release_Guide/release_steps/update_release_notes_official.rst index 02e077b4f6..d9e39e954d 100644 --- a/docs/Release_Guide/release_steps/update_release_notes_official.rst +++ b/docs/Release_Guide/release_steps/update_release_notes_official.rst @@ -6,21 +6,13 @@ release. Open the following URL in a browser: .. parsed-literal:: - https://github.com/orgs/dtcenter/projects?type=beta + https://github.com/orgs/dtcenter/projects * Click on the project that corresponds to this release, i.e. - |projectRepo|-X.Y.Z-rcN - -* Navigate to the "Closed Issues" tab. - **If this tab does not exist**, follow these instructions to create it: - - * Click on "+ New view" button on the far right side of the view tabs - * Click on "View " (where is an integer) and rename it to - "Closed Issues" - * Click on the down arrow next to the newly created view - * Click on "Search or filter this view" - * Enter the following info into the filter bar: **is:closed is:issue** - * Click on the down arrow next to the view and click "Save changes" + |projectRepo|-X.Y.Z Development + +* Navigate to the "Closed Issues" tab. If this tab does not exist, + see :ref:`wo-development-project` to create it. * Update the release-notes.rst file found in the User's Guide directory. From 0fd42787b3e0819e161f2f9a6627b6c16ec39b62 Mon Sep 17 00:00:00 2001 From: John Halley Gotway Date: Thu, 1 Dec 2022 12:29:46 -0700 Subject: [PATCH 08/10] Per #1885, use consist spelling of reassign. --- docs/Contributors_Guide/github_workflow.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index fd2250a19d..58e6b86ada 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -30,7 +30,7 @@ GitHub Projects to manage development Software development for official METplus releases is organized into development cycles. While the length a development cycle can vary widely, they are nominally 6 weeks long. GitHub issues and pull requests assigned to each cycle are either completed during the -time window for that cycle or re-assigned to a future development cycle. +time window for that cycle or reassigned to a future development cycle. Each development cycle culminates in the creation of a software release. The From 81fcde3080f63e3005095442fb87b60da80ed00f Mon Sep 17 00:00:00 2001 From: johnhg Date: Thu, 1 Dec 2022 15:21:09 -0700 Subject: [PATCH 09/10] Update docs/Contributors_Guide/github_workflow.rst Co-authored-by: George McCabe <23407799+georgemccabe@users.noreply.github.com> --- docs/Contributors_Guide/github_workflow.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index 58e6b86ada..b7e7a230b6 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -146,6 +146,12 @@ are required to perform the following steps. Click on the 3 horizontal bars and define the filtering criteria as **is:closed is:issue**. Click on the 3 dots in the **Cycle** column and select **Group by values**. Click **Save Changes**. + - View name **High/Blocker Not Required** shows all items labelled as *HIGH* or *BLOCKER* priority but + not marked as required for the development or official release. + Click on the 3 horizontal bars and define the filtering criteria as + **is:open label:"priority: high","priority: blocker" -label:"required: FOR DEVELOPMENT RELEASE" -label:"required: FOR OFFICIAL RELEASE"**. + Click **Save Changes**. + - Delete any other views created by default by clicking the down arrow next to the view name and selecting **Delete view**. From fe4674b26c07d0677832f5f95f81cbf4a76a1674 Mon Sep 17 00:00:00 2001 From: johnhg Date: Thu, 1 Dec 2022 15:21:43 -0700 Subject: [PATCH 10/10] Update docs/Contributors_Guide/github_workflow.rst Co-authored-by: George McCabe <23407799+georgemccabe@users.noreply.github.com> --- docs/Contributors_Guide/github_workflow.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Contributors_Guide/github_workflow.rst b/docs/Contributors_Guide/github_workflow.rst index b7e7a230b6..fe6496042c 100644 --- a/docs/Contributors_Guide/github_workflow.rst +++ b/docs/Contributors_Guide/github_workflow.rst @@ -132,7 +132,7 @@ are required to perform the following steps. - The blue dot on the down arrow for this tab indicates that there are unsaved changes. Select the **Save changes** option. - - Click on the down arrow and select **Duplicate View**. Do this 7 times and name/refine these views as follows. + - Click on the down arrow and select **Duplicate View**. Do this 8 times and name/refine these views as follows. - View name **All Required** shows all items labelled as *REQUIRED* for the development or official release. Click on the 3 horizontal bars and define the filtering criteria as