diff --git a/assets/images/help/projects-v2/bulk-cell-drag.png b/assets/images/help/projects-v2/bulk-cell-drag.png new file mode 100644 index 0000000000..fe8c6dc582 Binary files /dev/null and b/assets/images/help/projects-v2/bulk-cell-drag.png differ diff --git a/assets/images/help/projects-v2/bulk-cell-finished.png b/assets/images/help/projects-v2/bulk-cell-finished.png new file mode 100644 index 0000000000..fcea123458 Binary files /dev/null and b/assets/images/help/projects-v2/bulk-cell-finished.png differ diff --git a/assets/images/help/projects-v2/bulk-cell-handle.png b/assets/images/help/projects-v2/bulk-cell-handle.png new file mode 100644 index 0000000000..dc0b20b89b Binary files /dev/null and b/assets/images/help/projects-v2/bulk-cell-handle.png differ diff --git a/assets/images/help/projects-v2/bulk-select-a-cell.png b/assets/images/help/projects-v2/bulk-select-a-cell.png new file mode 100644 index 0000000000..ecc20ee5ea Binary files /dev/null and b/assets/images/help/projects-v2/bulk-select-a-cell.png differ diff --git a/assets/images/help/projects-v2/bulk-select-cells.png b/assets/images/help/projects-v2/bulk-select-cells.png new file mode 100644 index 0000000000..3ae4d716e2 Binary files /dev/null and b/assets/images/help/projects-v2/bulk-select-cells.png differ diff --git a/assets/images/help/projects-v2/select-multiple-cells.png b/assets/images/help/projects-v2/select-multiple-cells.png new file mode 100644 index 0000000000..8c69e825dd Binary files /dev/null and b/assets/images/help/projects-v2/select-multiple-cells.png differ diff --git a/assets/images/help/projects-v2/undo-bulk-change.png b/assets/images/help/projects-v2/undo-bulk-change.png new file mode 100644 index 0000000000..0c04f225e4 Binary files /dev/null and b/assets/images/help/projects-v2/undo-bulk-change.png differ diff --git a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project.md b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project.md index 6b0ece7440..42f49833ce 100644 --- a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project.md +++ b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project.md @@ -10,8 +10,6 @@ topics: allowTitleToDifferFromFilename: true --- -Your project can track draft issues, issues, and pull requests. - {% note %} **Note:** A project can contain a maximum of {% data variables.projects.item_limit %} items and {% data variables.projects.archived_item_limit %} archived items. {% ifversion projects-v2-auto-archive %}To learn more about automatically archiving items when they meet specific criteria, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/automating-your-project/archiving-items-automatically)."{% endif %} @@ -34,6 +32,12 @@ When you add an issue or pull request to your project, an event will be added to {% endif %} +{% ifversion projects-v2-bulk-table-editing %} + +For more information about making bulk changes to your items after adding them, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project)." + +{% endif %} + {% ifversion projects-v2-auto-add %} ### Automatically adding issues and pull requests diff --git a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project.md b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project.md new file mode 100644 index 0000000000..a429285ffb --- /dev/null +++ b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project.md @@ -0,0 +1,69 @@ +--- +title: 'Editing items in your {% data variables.projects.project_v2 %}' +shortTitle: Editing items +intro: 'There are several methods you can use within your {% data variables.projects.project_v2 %} to quickly make changes to multiple items.' +versions: + feature: projects-v2-bulk-table-editing +type: tutorial +topics: + - Projects +allowTitleToDifferFromFilename: true +--- + +## Copying and pasting cells in a table + +You can copy the contents of one cell and paste the contents into multiple other cells in the same field. + +1. Navigate to a project view that is using the table layout. +1. Select the cell that you would like to copy. + + ![Screenshot showing two columns on a table layout. One cell is selected and is highlighted with an orange outline.](/assets/images/help/projects-v2/bulk-select-a-cell.png) + +1. To copy the contents of the selected cell, press Command+C (Mac) or Ctrl+C (Windows.) +1. Select the destination cells for the copied content. + +{% indented_data_reference reusables.projects.select-a-cell spaces=4 %} + + ![Screenshot showing two columns on a table layout. Three cells are selected and are highlighted with an orange outline.](/assets/images/help/projects-v2/bulk-select-cells.png) + +1. To paste the previously copied content, press Command+V (Mac) or Ctrl+V (Windows.) + +## Dragging a cell's contents to set neighbouring table cells + +You can quickly copy one cell's content over other cells in the same field by dragging up or down. + +1. Navigate to a project view that is using the table layout. +1. Select the cell that you would like to copy. +1. If it's possible to copy the cell's content, a blue handle will be shown on the lower right of the selected cell. + + ![Screenshot showing two columns on a table layout. The blue handle, on the lower right of the selected cell, is highlighted with an orange outline.](/assets/images/help/projects-v2/bulk-cell-handle.png) + +1. Drag the handle up or down over the cells where you would like to copy the contents. + + ![Screenshot showing two columns on a table layout. Three cells are selected. The blue handle, on the lower right of the cell, is highlighted with an orange outline.](/assets/images/help/projects-v2/bulk-cell-drag.png) + +1. When you finish dragging, the contents of the originally selected cell will be copied over the cells you selected while dragging. + + ![Screenshot showing two columns on a table layout. The content of the previously selected cell has been copied to the cells selected above.](/assets/images/help/projects-v2/bulk-cell-finished.png) + +## Clearing the content of multiple table cells + +You can quickly clear the same field for multiple items. + +1. Navigate to a project view using the table layout. +1. Select the cells you would like to clear. + +{% indented_data_reference reusables.projects.select-a-cell spaces=4 %} + + ![Screenshot showing a column on a table layout. Three cells are selected.](/assets/images/help/projects-v2/select-multiple-cells.png) + +1. Press Delete or Backspace on your keyboard. + +## Undoing bulk changes in a table + +When you make a bulk change in the table layout, {% data variables.product.product_name %} will display the option to undo that change. + +1. Make a bulk change to your table. +1. When the notice appears in the lower right of your table, click **Undo**. + + ![Screenshot showing the undo dialog on a table. The Undo button is highlighted with an orange outline.](/assets/images/help/projects-v2/undo-bulk-change.png) diff --git a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/index.md b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/index.md index 0d43deeba0..460bb706af 100644 --- a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/index.md +++ b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/index.md @@ -10,7 +10,7 @@ topics: children: - /adding-items-to-your-project - /converting-draft-issues-to-issues + - /editing-items-in-your-project - /archiving-items-from-your-project allowTitleToDifferFromFilename: true --- - diff --git a/data/features/projects-v2-bulk-table-editing.yml b/data/features/projects-v2-bulk-table-editing.yml new file mode 100644 index 0000000000..67eec21638 --- /dev/null +++ b/data/features/projects-v2-bulk-table-editing.yml @@ -0,0 +1,5 @@ +# Issue 9957 +# Projects V2 - bulk editing tools for tables +versions: + fpt: '*' + ghec: '*' diff --git a/data/reusables/projects/select-a-cell.md b/data/reusables/projects/select-a-cell.md new file mode 100644 index 0000000000..5591d9697d --- /dev/null +++ b/data/reusables/projects/select-a-cell.md @@ -0,0 +1,4 @@ +- Hold Command (Mac) or Ctrl (Windows/Linux) and select each cell. +- Select an cell then press Shift+↑ or Shift+↓ to select additional cell above or below the selected item. +- Select an cell then press Shift and select another item to select all items between the two items. +- Holding your mouse button down, move the cursor over the cells you want to select. \ No newline at end of file