Skip to content

Commit

Permalink
Making the projects v1 screenshots accessible (#36662)
Browse files Browse the repository at this point in the history
Co-authored-by: Isaac Brown <[email protected]>
  • Loading branch information
guntrip and isaacmbrown authored Apr 27, 2023
1 parent e1b1b94 commit 89630fa
Show file tree
Hide file tree
Showing 52 changed files with 37 additions and 109 deletions.
Binary file modified assets/images/help/projects/add-cards-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/help/projects/add-note-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/help/projects/edit-column-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/help/projects/edit-team-discussions-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/help/projects/note-more-options.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/help/projects/project-board-copy-setting.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/help/projects/project-board-edit-settings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/help/projects/project-board-settings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/help/projects/project-list-action-chevron.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -26,10 +26,8 @@ A collaborator is a person who has permissions to a project board you own. A col
{% data reusables.project-management.access-collaboration-settings %}
{% data reusables.project-management.collaborator-option %}
5. Under "Search by username, full name or email address", type the collaborator's name, username, or {% data variables.product.prodname_dotcom %} email.
![The Collaborators section with the Octocat's username entered in the search field](/assets/images/help/projects/org-project-collaborators-find-name.png)
{% data reusables.project-management.add-collaborator %}
7. The new collaborator has read permissions by default. Optionally, next to the new collaborator's name, use the drop-down menu and choose a different permission level.
![The Collaborators section with the Permissions drop-down menu selected](/assets/images/help/projects/user-project-collaborators-edit-permissions.png)

## Removing a collaborator from a user-owned project board

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,8 +60,6 @@ You can use templates to quickly set up a new {% data variables.projects.project

For more information on automation for {% data variables.product.prodname_projects_v1 %}, see "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-automation-for-project-boards)."

![{% data variables.product.prodname_project_v1 %} with basic kanban template](/assets/images/help/projects/project-board-basic-kanban-template.png)

{% data reusables.project-management.copy-project-boards %}

## Further reading
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,9 @@ When you close a {% data variables.projects.projects_v1_board %}, any configured
If you reopen a {% data variables.projects.projects_v1_board %}, you have the option to *sync* automation, which updates the position of the cards on the board according to the automation settings configured for the board. For more information, see "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/reopening-a-closed-project-board)" or "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-automation-for-project-boards)."

1. Navigate to the list of {% data variables.projects.projects_v1_boards %} in your repository or organization, or owned by your personal account.
2. In the projects list, next to the {% data variables.projects.projects_v1_board %} you want to close, click {% octicon "chevron-down" aria-label="The chevron icon" %}.
![Chevron icon to the right of the project board's name](/assets/images/help/projects/project-list-action-chevron.png)
2. In the projects list, next to the {% data variables.projects.projects_v1_board %} you want to close, click {% octicon "kebab-horizontal" aria-label="Project menu" %}.
![Screenshot showing the projects index. The project menu icon is highlighted with an orange rectangle](/assets/images/help/projects/project-list-action-chevron.png)
3. Click **Close**.
![Close item in the project board's drop-down menu](/assets/images/help/projects/close-project.png)

## Further reading

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,14 +31,11 @@ allowTitleToDifferFromFilename: true
{% endtip %}

1. Navigate to the {% data variables.projects.projects_v1_board %} you want to automate.
2. In the column you want to automate, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}.
![Edit icon](/assets/images/help/projects/edit-column-button.png)
2. In the column you want to automate, click {% octicon "kebab-horizontal" aria-label="Column menu" %}.
![Screenshot showing a column in a project. The menu icon is highlighted with an orange outline.](/assets/images/help/projects/edit-column-button.png)
3. Click **Manage automation**.
![Manage automation button](/assets/images/help/projects/manage-automation-button.png)
4. Using the Preset drop-down menu, select an automation preset.
![Select preset automation from menu](/assets/images/help/projects/select-automation.png)
5. Select the workflow automations you want to configure for the column.
![List of options for automating the column](/assets/images/help/projects/select-automation-options-existing-column.png)
6. Click **Update automation**.

## Further reading
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,15 +25,10 @@ A {% data variables.projects.projects_v1_board %}'s automation is also enabled b
1. Navigate to the {% data variables.projects.projects_v1_board %} you want to copy.
{% data reusables.project-management.click-menu %}
3. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Copy**.
![Copy option in drop-down menu from project board sidebar](/assets/images/help/projects/project-board-copy-setting.png)
![Screenshot showing a project menu. The copy option is highlighted with an orange outline.](/assets/images/help/projects/project-board-copy-setting.png)
4. Under "Owner", use the drop-down menu and click the repository or organization where you want to copy the project board.
![Select owner of copied project board from drop-down menu](/assets/images/help/projects/copied-project-board-owner.png)
5. Optionally, under "Project board name", type the name of the copied {% data variables.projects.projects_v1_board %}.
![Field to type a name for the copied project board](/assets/images/help/projects/copied-project-board-name.png)
6. Optionally, under "Description", type a description of the copied project board that other people will see.
![Field to type a description for the copied project board](/assets/images/help/projects/copied-project-board-description.png)
7. Optionally, under "Automation settings", select whether you want to copy the configured automatic workflows. This option is enabled by default. For more information, see "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-automation-for-project-boards)."
![Select automation settings for copied project board](/assets/images/help/projects/copied-project-board-automation-settings.png)
{% data reusables.project-management.choose-visibility %}
9. Click **Copy project**.
![Confirm Copy button](/assets/images/help/projects/confirm-copy-project-board.png)
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,9 @@ You can also configure workflow automations to keep your {% data variables.proje
{% data reusables.projects.classic-project-creation %}

{% data reusables.profile.access_profile %}
1. On the top of your profile page, in the main navigation, click {% octicon "project" aria-label="The project board icon" %} **Projects**.
1. On the top of your profile page, in the main navigation, click {% octicon "project" aria-hidden="true" %} **Projects**.

![Project tab](/assets/images/help/projects/user-projects-tab.png){% ifversion projects-v2 %}
![Screenshot showing profile tabs. The 'Projects' tab is highlighted with an orange outline.](/assets/images/help/projects-v2/tab-projects.png){% ifversion projects-v2 %}

1. Click **Projects (classic)**{% endif %}
{% data reusables.project-management.click-new-project %}
Expand Down Expand Up @@ -93,8 +93,7 @@ You can also configure workflow automations to keep your {% data variables.proje
{% data reusables.projects.classic-project-creation %}

{% data reusables.repositories.navigate-to-repo %}
2. Under your repository name, click {% octicon "project" aria-label="The project board icon" %} **Projects**.
![Project tab](/assets/images/help/projects/repo-tabs-projects.png){% ifversion projects-v2 %}
2. Under your repository name, click {% octicon "project" aria-hidden="true" %} **Projects**.{% ifversion projects-v2 %}
1. Click **Projects (classic)**{% endif %}
{% data reusables.project-management.click-new-project %}
{% data reusables.project-management.create-project-name-description %}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ allowTitleToDifferFromFilename: true
{% data reusables.project-management.click-menu %}
{% data reusables.project-management.click-edit-sidebar-menu-project-board %}
4. Click **Delete project**.
![Delete project button](/assets/images/help/projects/delete-project-button.png)
5. To confirm that you want to delete the project board, click **OK**.

## Further reading
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,6 @@ allowTitleToDifferFromFilename: true
{% data reusables.project-management.click-menu %}
{% data reusables.project-management.click-edit-sidebar-menu-project-board %}
4. Modify the {% data variables.projects.projects_v1_board %} name and description as needed, then click **Save project**.
![Fields with the project board name and description, and Save project button](/assets/images/help/projects/edit-project-board-save-button.png)

## Further reading

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,13 +22,9 @@ Anyone with write permissions to a {% data variables.projects.projects_v1_board
{% data reusables.project-management.click-menu %}
{% data reusables.project-management.access-collaboration-settings %}
4. In the left sidebar, click **Linked repositories**.
![Linked repositories menu option in left sidebar](/assets/images/help/projects/project-board-linked-repositories-setting.png)
5. Click **Link a repository**.
![Link a repository button on Linked repositories tab](/assets/images/help/projects/link-repository-button.png)
6. Search for the repository you'd like to link.
![Search field on Link a repository window](/assets/images/help/projects/search-to-link-repository.png)
7. Click **Link**. To unlink, click **Unlink**.
![Link button](/assets/images/help/projects/link-button.png)

{% note %}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,7 @@ When you reopen a {% data variables.projects.projects_v1_board %}, you have the
{% data reusables.project-management.click-menu %}
3. Choose whether to sync automation for your {% data variables.projects.projects_v1_board %} or reopen your {% data variables.projects.projects_v1_board %} without syncing.
- To reopen your {% data variables.projects.projects_v1_board %} and sync automation, click **Reopen and sync project**.
![Select "Reopen and resync project" button](/assets/images/help/projects/reopen-and-sync-project.png)
- To reopen your {% data variables.projects.projects_v1_board %} without syncing automation, using the reopen drop-down menu, click **Reopen only**. Then, click **Reopen only**.
![Reopen closed project board drop-down menu](/assets/images/help/projects/reopen-closed-project-board-drop-down-menu.png)

## Further reading

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,6 @@ You can add issue or pull request cards to your {% data variables.projects.proje

You can put a maximum of 2,500 cards into each project column. If a column has reached the maximum number of cards, no cards can be moved into that column.

![Cursor moves issue card from triaging sidebar to project board column](/assets/images/help/projects/add-card-from-sidebar.gif)

{% note %}

**Note:** You can also add notes to your project board to serve as task reminders, references to issues and pull requests from any repository on {% data variables.product.product_name %}, or to add related information to your {% data variables.projects.projects_v1_board %}. For more information, see "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-notes-to-a-project-board)."
Expand All @@ -38,7 +36,7 @@ You can put a maximum of 2,500 cards into each project column. If a column has r

1. Navigate to the {% data variables.projects.projects_v1_board %} where you want to add issues and pull requests.
2. In your {% data variables.projects.projects_v1_board %}, click {% octicon "plus" aria-label="The plus icon" %} **Add cards**.
![Add cards button](/assets/images/help/projects/add-cards-button.png)
![Screenshot showing the header of a project. The "Add cards" button is highlighted with an orange outline.](/assets/images/help/projects/add-cards-button.png)
3. Search for issues and pull requests to add to your {% data variables.projects.projects_v1_board %} using search qualifiers such as `is:issue is:open`. For more information on search qualifiers you can use, see "[AUTOTITLE](/search-github/searching-on-github/searching-issues-and-pull-requests)."

{% tip %}
Expand All @@ -59,15 +57,14 @@ You can put a maximum of 2,500 cards into each project column. If a column has r
## Adding issues and pull requests to a {% data variables.projects.projects_v1_board %} from the sidebar

1. On the right side of an issue or pull request, click **Projects {% octicon "gear" aria-label="The Gear icon" %}**.
![Project board button in sidebar](/assets/images/help/projects/sidebar-project.png)
2. Click the **Recent**, **Repository**,**User**, or **Organization** tab for the {% data variables.projects.projects_v1_board %} you would like to add to.
![Recent, Repository and Organization tabs](/assets/images/help/projects/sidebar-project-tabs.png)

![Screenshot showing an issue's sidebar. The "Projects" section header is highlighted with an orange outline.](/assets/images/help/projects-v2/issue-sidebar-projects.png)

2. Click the **Recent**, **Repository**, **User**, or **Organization** tab for the {% data variables.projects.projects_v1_board %} you would like to add to.
3. Type the name of the project in **Filter projects** field.
![Project board search box](/assets/images/help/projects/sidebar-search-project.png)
4. Select one or more {% data variables.projects.projects_v1_boards %} where you want to add the issue or pull request.
![Selected project board](/assets/images/help/projects/sidebar-select-project.png)
5. Click {% octicon "triangle-down" aria-label="The down triangle icon" %}, then click the column where you want your issue or pull request. The card will move to the bottom of the {% data variables.projects.projects_v1_board %} column you select.
![Move card to column menu](/assets/images/help/projects/sidebar-select-project-board-column-menu.png)
5. Click **Awaiting triage**{% octicon "triangle-down" aria-hidden="true" %}, then click the column where you want your issue or pull request. The card will move to the bottom of the {% data variables.projects.projects_v1_board %} column you select.
![Screenshot showing the projects section in an issue's sidebar. The awaiting triage option is highlighted with an orange outline](/assets/images/help/projects/sidebar-select-project-board-column-menu.png)

## Further reading

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,15 +26,12 @@ allowTitleToDifferFromFilename: true

When you add a URL for an issue, pull request, or another {% data variables.projects.projects_v1_board %} to a note, you'll see a preview in a summary card below your text.

![Project board cards showing a preview of an issue and another project board](/assets/images/help/projects/note-with-summary-card.png)

## Adding notes to a {% data variables.projects.projects_v1_board %}

1. Navigate to the {% data variables.projects.projects_v1_board %} where you want to add notes.
2. In the column you want to add a note to, click {% octicon "plus" aria-label="The plus icon" %}.
![Plus icon in the column header](/assets/images/help/projects/add-note-button.png)
2. In the column you want to add a note to, click {% octicon "plus" aria-label="Add a note to this column" %}.
![Screenshot showing a project column. The 'add a note to this column' button is highlighted with an orange outline.](/assets/images/help/projects/add-note-button.png)
3. Type your note, then click **Add**.
![Field for typing a note and Add card button](/assets/images/help/projects/create-and-add-note-button.png)

{% tip %}

Expand All @@ -57,11 +54,8 @@ When you convert a note to an issue, the issue is automatically created using th
1. Navigate to the note that you want to convert to an issue.
{% data reusables.project-management.project-note-more-options %}
3. Click **Convert to issue**.
![Convert to issue button](/assets/images/help/projects/convert-to-issue.png)
4. If the card is on an organization-wide {% data variables.projects.projects_v1_board %}, in the drop-down menu, choose the repository you want to add the issue to.
![Drop-down menu listing repositories where you can create the issue](/assets/images/help/projects/convert-note-choose-repository.png)
5. Optionally, edit the pre-filled issue title, and type an issue body.
![Fields for issue title and body](/assets/images/help/projects/convert-note-issue-title-body.png)
6. Click **Convert to issue**.
7. The note is automatically converted to an issue. In the {% data variables.projects.projects_v1_board %}, the new issue card will be in the same location as the previous note.

Expand All @@ -70,9 +64,7 @@ When you convert a note to an issue, the issue is automatically created using th
1. Navigate to the note that you want to edit or remove.
{% data reusables.project-management.project-note-more-options %}
3. To edit the contents of the note, click **Edit note**.
![Edit note button](/assets/images/help/projects/edit-note.png)
4. To delete the contents of the notes, click **Delete note**.
![Delete note button](/assets/images/help/projects/delete-note.png)

## Further reading

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,13 @@ Automation in your {% data variables.projects.projects_v1_board %} does not appl

## Archiving cards on a {% data variables.projects.projects_v1_board %}

1. In a {% data variables.projects.projects_v1_board %}, find the card you want to archive, then click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}.
![List of options for editing a project board card](/assets/images/help/projects/select-archiving-options-project-board-card.png)
1. In a {% data variables.projects.projects_v1_board %}, find the card you want to archive, then click {% octicon "kebab-horizontal" aria-label="Card menu" %}.
![Screenshot showing a card on a project. The card menu icon is highlighted with an orange outline.](/assets/images/help/projects/select-archiving-options-project-board-card.png)
2. Click **Archive**.
![Select archive option from menu](/assets/images/help/projects/archive-project-board-card.png)

## Restoring cards on a {% data variables.projects.projects_v1_board %} from the sidebar

{% data reusables.project-management.click-menu %}
2. Click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **View archive**.
![Select view archive option from menu](/assets/images/help/projects/select-view-archive-option-project-board-card.png)
2. Click {% octicon "kebab-horizontal" aria-label="Project menu" %}, then click **View archive**.
![Screenshot showing the project menu. The "View archive" option is highlighted with an orange outline.](/assets/images/help/projects/select-view-archive-option-project-board-card.png)
3. Above the {% data variables.projects.projects_v1_board %} card you want to unarchive, click **Restore**.
![Select restore project board card](/assets/images/help/projects/restore-card.png)
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,6 @@ You can also use the "Filter cards" search bar at the top of each {% data variab

1. Navigate to the {% data variables.projects.projects_v1_board %} that contains the cards you want to filter.
2. Above the project card columns, click into the "Filter cards" search bar and type a search query to filter the cards.
![Filter card search bar](/assets/images/help/projects/filter-card-search-bar.png)

{% tip %}

Expand Down
Loading

0 comments on commit 89630fa

Please sign in to comment.