repo sync

content/issues/tracking-your-work-with-issues/closing-an-issue.md

@@ -0,0 +1,33 @@
+---
+title: Closing an issue
+intro: 'You can close an issue when bugs are fixed, feedback is acted on, or to show that work is not planned.'
+permissions: 'Anyone can close an issue they opened.<br><br>Repository owners, collaborators on repositories owned by a personal account, and people with triage permissions or greater on repositories owned by an organization can close issues opened by others. {% data reusables.enterprise-accounts.emu-permission-repo %}'
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghae: '*'
+  ghec: '*'
+topics:
+  - Issues
+  - Project management
+shortTitle: Close an issue
+---
+
+{% note %}
+
+**Note:** You can also close issues automatically with keywords in pull requests and commit messages. For more information, see "[Linking a pull request to an issue](/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword#linking-a-pull-request-to-an-issue-using-a-keyword)."
+
+{% endnote %}
+
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.repositories.sidebar-issues %}
+1. In the list of issues, click the issue you'd like to close.
+{%- if issue-close-reasons %}
+1. Optionally, to change the reason for closing the issue, select {% octicon "triangle-down" aria-label="The down triangle octicon" %} next to "Close issue" and click a reason.
+   ![Screenshot showing dropdown menu containing issue close reasons](/assets/images/help/issues/close-issue-select-reason.png)
+2. Click **Close issue**.
+   ![Screenshot showing "close issue" button](/assets/images/help/issues/close-issue-with-reason.png)
+{%- else %}
+1. At the bottom of the page, click **Close issue**.
+   ![Screenshot showing "close issue" button](/assets/images/help/issues/close-issue.png)
+{% endif %}

content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md

@@ -180,7 +180,8 @@ With issue and pull request search terms, you can:
 
 For issues, you can also use search to:
 
-- Filter for issues that are linked to a pull request by a closing reference: `linked:pr`
+- Filter for issues that are linked to a pull request by a closing reference: `linked:pr`{% if issue-close-reasons %}
+- Filter issues by the reason they were closed: `is:closed reason:complete` or `is:closed reason:"not planned"`{% endif %}
 
 For pull requests, you can also use search to:
 - Filter [draft](/articles/about-pull-requests#draft-pull-requests) pull requests: `is:draft`

content/issues/tracking-your-work-with-issues/index.md

@@ -22,6 +22,7 @@ children:
   - /marking-issues-or-pull-requests-as-a-duplicate
   - /pinning-an-issue-to-your-repository
   - /transferring-an-issue-to-another-repository
+  - /closing-an-issue
   - /deleting-an-issue
   - /planning-and-tracking-work-for-your-team-or-project
 redirect_from:

content/issues/trying-out-the-new-projects-experience/index.md

@@ -17,6 +17,7 @@ children:
   - /filtering-projects
   - /using-the-api-to-manage-projects
   - /automating-projects
+  - /managing-projects
   - /managing-the-visibility-of-your-projects
   - /managing-access-to-projects
   - /using-insights-with-projects

content/issues/trying-out-the-new-projects-experience/managing-projects.md

@@ -0,0 +1,46 @@
+---
+title: Managing projects (beta)
+intro: 'You can close and re-open projects, or you can permanently delete projects.'
+allowTitleToDifferFromFilename: true
+miniTocMaxHeadingLevel: 2
+versions:
+  fpt: '*'
+  ghec: '*'
+topics:
+  - Projects
+  - Organizations
+---
+
+## Deleting a project
+
+You can delete a project to permanently remove it.
+
+{% data reusables.projects.project-settings %}
+1. At the bottom of the page, click **Delete this project**. 
+   ![Screenshot showing project delete button](/assets/images/help/issues/delete-project-button.png)
+1. Read the warnings, then type the name of your project into the text box.
+   ![Screenshot showing project delete confirmation](/assets/images/help/issues/project-delete-confirm.png)
+1. Click **I understand the consequences, delete this project**.
+
+## Closing a project
+
+You can close a project to remove it from the list of projects but retain the contents and ability to re-open the project later. 
+
+{% data reusables.projects.project-settings %}
+1. At the bottom of the page, click **Close this project**. 
+   ![Screenshot showing project close button](/assets/images/help/issues/close-project-button.png)
+
+## Re-opening an organization project
+
+You can reopen a previously closed project.
+
+{% data reusables.profile.access_org %}
+{% data reusables.user-settings.access_org %}
+{% data reusables.projects.reopen-a-project %}
+
+## Re-opening a user project
+
+You can reopen a previously closed project.
+
+{% data reusables.profile.access_profile %}
+{% data reusables.projects.reopen-a-project %}

content/search-github/searching-on-github/searching-issues-and-pull-requests.md

@@ -71,6 +71,18 @@ You can filter issues and pull requests based on whether they're open or closed
 | `is:open` | [**performance is:open is:issue**](https://github.com/search?q=performance+is%3Aopen+is%3Aissue&type=Issues) matches open issues with the word "performance."
 | `is:closed` | [**android is:closed**](https://github.com/search?utf8=%E2%9C%93&q=android+is%3Aclosed&type=) matches closed issues and pull requests with the word "android."
 
+{% if issue-close-reasons %}
+## Search by the reason an issue was closed
+
+You can filter issues based on the reason given when the issue was closed, using the `reason` qualifier.
+
+| Qualifier        | Example
+| ------------- | -------------
+| `reason:complete` | [**libraries is:closed reason:complete**](https://github.com/search?q=libraries+is%3Aclosed+reason%3Acompleted&type=Issues) matches issues with the word "libraries" that were closed as "completed."
+| `reason:"not planned"` | [**libraries is:closed reason:"not planned"**](https://github.com/search?q=libraries+is%3Aclosed+reason%3A%22not+planned%22&type=Issues) matches issues with the word "libraries" that were closed as "not planned."
+
+{% endif %}
+
 ## Filter by repository visibility
 
 You can filter by the visibility of the repository containing the issues and pull requests using the `is` qualifier. For more information, see "[About repositories](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)."

data/features/issue-close-reasons.yml

@@ -0,0 +1,7 @@
+# Issues 6363
+# Closed issue states
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '>=3.6'
+  ghae: 'issue-6363'

data/reusables/projects/create-project.md

@@ -1,5 +1,8 @@
 1. On {% data variables.product.prodname_dotcom %}, navigate to the main page of your organization.
-2. Click {% octicon "table" aria-label="The project icon" %} **Projects**.
-3. Select the **New project** drop-down menu and click **New project (Beta)**.
+1. Click {% octicon "table" aria-label="The project icon" %} **Projects**.
+1. Select the **New project** drop-down menu and click **New project (Beta)**.
 
    ![New project](/assets/images/help/issues/new_project_beta.png)
+1. When prompted to select a template, click a template or, to start with an empty project, click "Table" or "Board". Then, click **Create**.
+
+   ![Screenshot showing template selection modal](/assets/images/help/issues/projects-select-template.png)

data/reusables/projects/create-user-project.md

@@ -1,4 +1,7 @@
 1. On any {% data variables.product.product_name %} page, click on your avatar, then select **Your projects**.
-2. Select the **New project** drop-down menu and click **New project (Beta)**.
+1. Select the **New project** drop-down menu and click **New project (Beta)**.
 
    ![New project](/assets/images/help/issues/new_project_beta.png)
+1. When prompted to select a template, click a template or, to start with an empty project, click "Table" or "Board". Then, click **Create**.
+
+   ![Screenshot showing template selection modal](/assets/images/help/issues/projects-select-template.png)

data/reusables/projects/reopen-a-project.md

@@ -0,0 +1,9 @@
+1. Click the **Projects** tab.
+   ![Screenshot showing project close button](/assets/images/help/issues/projects-profile-tab.png)
+1. To show closed projects, click **Closed**.
+   ![Screenshot showing project close button](/assets/images/help/issues/closed-projects-tab.png)
+1. Click the project you want to reopen.
+1. In the top-right, click {% octicon "kebab-horizontal" aria-label="The menu icon" %} to open the menu.
+1. In the menu, to access the project settings, click {% octicon "gear" aria-label="The gear icon" %} **Settings**.
+1. At the bottom of the page, click **Re-open project**.
+   ![Screenshot showing project re-open button](/assets/images/help/issues/reopen-project-button.png)