[Do not merge before July 16] Add docs for archiving pull requests (#62277)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>
Copilot-Session: b4471baf-828f-4d31-8b1b-477ac89b700f

Author: 4 people

content/communities/moderating-comments-and-conversations/archive-pull-requests.md

@@ -0,0 +1,39 @@
+---
+title: Archive pull requests
+intro: Repository administrators can archive a pull request to remove it from public view, providing a moderation option between leaving a pull request up and permanently deleting it.
+versions:
+  feature: archive-pull-requests
+category:
+  - Moderate comments and conversations
+redirect_from:
+  - /communities/moderating-comments-and-conversations/archiving-pull-requests
+contentType: other
+permissions: Repository administrators
+---
+
+## About archiving pull requests
+
+Archiving a pull request removes it from public view while preserving its history for repository administrators. This provides a safer moderation path when they need to take a pull request out of public view without permanently deleting it.
+
+When a pull request is archived:
+
+* The pull request is only visible to repository administrators. Visitors without administrator access to the repository receive a 404 error.
+* The pull request is automatically closed and locked.
+
+When you unarchive a pull request, it becomes visible again, but it remains closed and locked. You can reopen and unlock it separately if needed.
+
+## Archiving a pull request
+
+{% data reusables.repositories.navigate-to-repo %}
+{% data reusables.repositories.sidebar-pr %}
+1. Click the pull request you want to archive.
+1. Scroll to the bottom of the right sidebar. Then click **{% octicon "archive" aria-hidden="true" aria-label="archive" %} Archive pull request**.
+1. Read the information about archiving the pull request, then confirm that you want to archive it.
+
+## Unarchiving a pull request
+
+You can find the PR by using the `is:archived` qualifier. See, [AUTOTITLE](/search-github/searching-on-github/searching-issues-and-pull-requests#search-based-on-whether-a-pull-request-is-archived).
+
+1. Open the pull request you want to unarchive.
+1. In the right sidebar, click **{% octicon "archive" aria-hidden="true" aria-label="unarchive" %} Unarchive pull request**.
+1. Read the information about unarchiving the pull request, then confirm that you want to unarchive it.

content/communities/moderating-comments-and-conversations/index.md

@@ -1,7 +1,7 @@
 ---
 title: Moderating comments and conversations
 shortTitle: Moderation
-intro: 'Moderating conversations creates a welcoming community for all contributors to your project by promoting healthy collaboration and de-escalating conflict. You can apply your community''s code of conduct to discussions by viewing reported content, editing and deleting comments, and locking conversations.'
+intro: Moderating conversations creates a welcoming community for all contributors to your project by promoting healthy collaboration and de-escalating conflict. You can apply your community's code of conduct to discussions by viewing reported content, editing and deleting comments, and locking conversations.
 redirect_from:
   - /articles/moderating-comments-and-conversations
   - /github/building-a-strong-community/moderating-comments-and-conversations
@@ -12,6 +12,7 @@ versions:
 children:
   - /managing-disruptive-comments
   - /locking-conversations
+  - /archive-pull-requests
   - /limiting-interactions-in-your-repository
   - /limiting-interactions-for-your-personal-account
   - /limiting-interactions-in-your-organization

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

@@ -68,6 +68,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."
 
+{% ifversion archive-pull-requests %}
+
+## Search based on whether a pull request is archived
+
+Repository administrators can archive a pull request to remove it from public view. You can search for archived pull requests using the `is:archived` qualifier. For more information, see [AUTOTITLE](/communities/moderating-comments-and-conversations/archive-pull-requests).
+
+| Qualifier        | Example
+| ------------- | -------------
+| `is:archived` | [**is:archived is:pr spam**](https://github.com/search?q=is%3Aarchived+is%3Apr+spam) matches archived pull requests that contain the word "spam" in repositories where you are a repository administrator.
+
+{% endif %}
+
 ## Search for pull requests in the merge queue
 
 You can also use the `is` qualifier to find pull requests that are queued to merge.

data/features/archive-pull-requests.yml

@@ -0,0 +1,6 @@
+# Reference: https://github.com/github/docs-content/issues/21075
+# Archiving pull requests moderation feature
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '>=3.21'