diff --git a/assets/images/help/issues/burnup-example.png b/assets/images/help/issues/burnup-example.png index 6d322ec2af..173a7c7191 100644 Binary files a/assets/images/help/issues/burnup-example.png and b/assets/images/help/issues/burnup-example.png differ diff --git a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md index 86aa069d9b..7fca9dfad9 100644 --- a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md +++ b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md @@ -13,11 +13,9 @@ topics: allowTitleToDifferFromFilename: true --- -{% data reusables.projects.insights-release-note %} - You can use insights for {% data variables.product.prodname_projects_v2 %} to view, create, and customize charts that use the items added to your project as their source data. You can apply filters to the default chart and also create your own charts. When you create a chart, you set the filters, chart type, the information displayed, and the chart is available to anyone that can view the project. You can generate two types of chart: current charts and historical charts. - Insights does not track items you have archived or deleted. +Insights does not track items you have archived or deleted. ## About current charts @@ -27,17 +25,19 @@ You can also use filters to manipulate the data used to build your chart. For ex ![Screenshot of a stacked column chart, with a column for each iteration. Each column is divided into sections for "Bug", "Feedback", "Backend", and "UI."](/assets/images/help/issues/column-chart-example.png) -For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts)." +For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts)" and "[AUTOTITLE](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts)." ## About historical charts -Historical charts are time-based charts that allow you to view your project's trends and progress. You can view the number of items, grouped by status and other fields, over time. +You can create historical charts to visualize your project items over time. Historical charts track changes to the state of your project items. You can see "Open" items with open issues and pull requests, "Completed" items with issues that were closed as completed or merged pull requests, "Closed pull requests", and "Not planned" items with issues that were closed as not planned. You can view the number of items or aggregation of items over time. -The default "Burn up" chart shows item status over time, allowing you to visualize progress and spot patterns over time. +The default "Burn up" chart allows you to visualize the progress of your issues over time, showing how much work is completed and how much is left to do. You can use this chart to view progress, spot trends, and identify bottlenecks to help move the project forward. -![Screenshot of an example burn up chart.](/assets/images/help/issues/burnup-example.png) +![Screenshot of an example "Burn up" chart, showing the amount of issues over a two-week period split into the categories "Open", "Completed", and "Not planned". The chart uses horizontal lines to plot the number of issues in each category for each day in the two week period.](/assets/images/help/issues/burnup-example.png) -To create a historical chart, set your chart's X-axis to "Time." For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts)" and "[AUTOTITLE](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts)." +To create a historical chart, set your chart's X-axis to "Time." You can also use filters to manipulate the data used to build your chart. For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects)." + +For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts)" and "[AUTOTITLE](/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts)." ## Further reading diff --git a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts.md b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts.md index 5d82045339..559345685b 100644 --- a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts.md +++ b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts.md @@ -10,13 +10,11 @@ topics: - Projects --- -{% data reusables.projects.insights-release-note %} - {% data reusables.projects.access-insights %} 1. In the menu on the left, click on the chart you would like to configure. 1. On the right side of the page, click **Configure**. A panel will open on the right. 1. To change the type of chart, select the **Layout** dropdown and click on the chart type you want to use. 1. To change the field used for your chart's X-axis, select the **X-axis** dropdown and click the field you want to use. -1. Optionally, to group the items on your X-axis by another field, select **Group by** and click on the field you want to use, or click "None" to disable grouping. +1. Optionally, for current charts, to group the items on your X-axis by another field, select **Group by** and click on the field you want to use, or click "None" to disable grouping. 1. Optionally, if your project contains number fields and you want the Y-axis to display the sum, average, minimum, or maximum of one of those number fields, select **Y-axis** and click an option. Then, select the dropdown that appears beneath and click on the number field you want to use. 1. To save your chart, click **Save changes**. diff --git a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts.md b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts.md index 58788de6a3..b95ca635b2 100644 --- a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts.md +++ b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts.md @@ -10,8 +10,6 @@ topics: - Projects --- -{% data reusables.projects.insights-release-note %} - {% data reusables.projects.access-insights %} 1. In the menu on the left, click **New chart**. 1. Optionally, to change the name of the new chart, click {% octicon "triangle-down" aria-label="The triangle icon" %}, type a new name, and press Return. diff --git a/data/reusables/projects/insights-release-note.md b/data/reusables/projects/insights-release-note.md deleted file mode 100644 index 0f470ef4e4..0000000000 --- a/data/reusables/projects/insights-release-note.md +++ /dev/null @@ -1,9 +0,0 @@ -{% ifversion projects-v1 %} - -{% note %} - -**Note:** Support for the **Group by** field in historical charts is being removed and will be gradually phased out on existing historical charts over the coming weeks. In the meantime, new accounts and newly upgraded accounts will not have access to historical charts. - -{% endnote %} - -{% endif %} \ No newline at end of file