You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a87148f
Browse filesBrowse the repository at this point in the historyBrowse files
authored
Document triage access to archived pull requests (#63778)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com>
Copilot-Session: 13e1ed25-383c-4ea0-9c3a-0e1b5600160c
Copy file name to clipboardExpand all lines: content/communities/moderating-comments-and-conversations/archive-pull-requests.md
+21-4Lines changed: 21 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,27 +1,44 @@
1
1
---
2
2
title: Archive pull requests
3
-
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.
3
+
intro: Archiving a pull request removes it from public view without permanently deleting it.
permissions: '{% ifversion triage-archive-pull-requests %}People with triage access or higher to a repository{% else %}Repository administrators{% endif %}'
12
12
---
13
13
14
14
## About archiving pull requests
15
15
16
-
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.
16
+
Archiving a pull request removes it from public view while preserving its history for {% ifversion triage-archive-pull-requests %}people with triage access or higher to the repository{% else %}repository administrators{% endif %}. This provides a safer moderation path when they need to take a pull request out of public view without permanently deleting it.
17
+
18
+
{% ifversion triage-archive-pull-requests %}
19
+
20
+
Anyone with the triage, write, maintain, or admin role in a repository can archive, unarchive, and view archived pull requests.
21
+
22
+
{% endif %}
17
23
18
24
When a pull request is archived:
19
25
26
+
{% ifversion triage-archive-pull-requests %}
27
+
28
+
* The pull request is only visible to people with triage access or higher to the repository. Visitors without this access receive a 404 error.
29
+
* The pull request is automatically closed and its conversation becomes read-only. New comments, reactions, and automated comments are blocked, including comments from repository administrators.
30
+
31
+
When you unarchive a pull request, it becomes visible again and people can comment and react again, but it remains closed. You can reopen it separately if needed.
32
+
33
+
{% else %}
34
+
20
35
* The pull request is only visible to repository administrators. Visitors without administrator access to the repository receive a 404 error.
21
36
* The pull request is automatically closed and locked.
22
37
23
38
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.
24
39
40
+
{% endif %}
41
+
25
42
## Archiving a pull request
26
43
27
44
{% data reusables.repositories.navigate-to-repo %}
@@ -32,7 +49,7 @@ When you unarchive a pull request, it becomes visible again, but it remains clos
32
49
33
50
## Unarchiving a pull request
34
51
35
-
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).
52
+
You can find archived pull requests 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).
36
53
37
54
1. Open the pull request you want to unarchive.
38
55
1. In the right sidebar, click **{% octicon "archive" aria-hidden="true" aria-label="unarchive" %} Unarchive pull request**.
Copy file name to clipboardExpand all lines: content/search-github/searching-on-github/searching-issues-and-pull-requests.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -72,11 +72,11 @@ You can filter issues and pull requests based on whether they're open or closed
72
72
73
73
## Search based on whether a pull request is archived
74
74
75
-
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).
75
+
{% ifversion triage-archive-pull-requests %}People with triage access or higher to a repository can archive, unarchive, and view archived pull requests. Archiving removes a pull request from public view.{% else %}Repository administrators can archive a pull request to remove it from public view.{% endif %} 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).
76
76
77
77
| Qualifier | Example
78
78
| ------------- | -------------
79
-
| `is:archived` | [**is:archived is:pr spam**](https://github.com/search?q=is%3Aarchived+is%3Apr+spam&ref_product=github&ref_type=engagement&ref_style=text) matches archived pull requests that contain the word "spam" in repositories where you are a repository administrator.
79
+
| `is:archived` | [**is:archived is:pr spam**](https://github.com/search?q=is%3Aarchived+is%3Apr+spam&ref_product=github&ref_type=engagement&ref_style=text) matches archived pull requests that contain the word "spam" in repositories where you {% ifversion triage-archive-pull-requests %}have triage access or higher{% else %}are a repository administrator{% endif %}.
0 commit comments