Update issues-pr-management.md (#45693)

Change to present tense, as we're now merged.
Document workflow enabled in #44775

docs/issues-pr-management.md

@@ -1,29 +1,27 @@
 # Issue and Pull Request Management
-The purpose of this document is to help establish norms and best practices for dotnet/runtime.  The outcomes from this document should be translated into the respective documentation within dotnet/runtime, though initially it will be a standalone document.
+The purpose of this document is to help establish norms and best practices for dotnet/runtime.
 # Principles
 Here are a guiding set of principles of how to successfully combine the communities and teams which work together in dotnet/runtime.
 - Retain a 'one community/team' feel for dotnet/runtime
 - Leverage automation to label incoming/inflight to enable accountability
 - area-* labels should align with a specific community/team for accountability
 - Within an area-* there is leeway for community/team specific practices
-- Leverage the best ideas from each community/team and find a common pattern for dotnet/runtime
 # Details
-dotnet/runtime issues and pull requests are a shared resource.  As such, it will likely be one of the first places where coming together as 'one community/team' will be first felt.  In alignment with the Principles the goal is to find a set of norms and best practices which enable the joint community within dotnet/runtime to successfully merge, understand what is expected, act as 'one community/team', and provide leeway at the area level.
+dotnet/runtime issues and pull requests are a shared resource. In alignment with the Principles the goal is to find a set of norms and best practices which enable a successful community within dotnet/runtime, understand what is expected, act as 'one community/team', and provide leeway at the area level.
 
 Here are a few of the most salient components of working well together, and the FAQ has much more detail.
-## Scenarios where we all have to work together:
-- All incoming issues and pull requests will be automatically labeled with an `area-*` label. The bot will also assign the `untriaged` label to only issues, once they get created.
+## Common policies:
+- All incoming issues and pull requests are automatically labeled with an `area-*` label. The bot also assigns the `untriaged` label to issues (not pull requests), once they get created.
 - All issues and pull requests should have exactly 1 `area-*` label.
-- Issues are considered triaged when the `untriaged` label has been removed.
+- Issues are considered triaged when the `untriaged` label has been removed. There is a `needs further triage` label that can be used to tag issues that need another look later.
 - When issues have `area-*` labels switched, the `untriaged` label must be added. This prevents issues being lost in a `triaged` state when they have not actually been triaged by the area owner. In the future, a bot may automatically ensure this happens.
 - The central repository owner is accountable for triaging issues and pull requests without `area-*` labels.  This occurs when automation is not able to determine the appropriate area.
-- Any area-* label that has overlap with merged technologies will be appended with the src/subfolder name: eg. `area-Infrastructure` will also have an `area-Infrastructure-libraries`, `area-Infrastructure-coreclr`, and `area-Infrastructure-installer`.
-- There are shared resources in dotnet/runtime which we should be conscientious of use:
+- Any area-* label that has overlap with merged technologies is appended with the src/subfolder name: eg. `area-Infrastructure` also has an `area-Infrastructure-libraries`, `area-Infrastructure-coreclr`, and `area-Infrastructure-installer`.
 - Labels/Milestones – all `area-*` labels are shared, if you are updating/adding keep everyone in dotnet/runtime in mind.  All labels and milestones are shared, be a conscientious citizen when updating/adding.
-- ProjectBoards/ZenHub – some aspects of these project boards are shared across all users.
-- Wikis/GitActions – these resources are global and are disabled
+- We lock closed issues and pull requests after 30 days of inactivity. The reason for this is that it is easy for us to overlook new comments on closed issues and PR's. Instead we encourage folks to create a new issue.
+
 ## Scenarios where area owners will be asked to manage their issues and pull requests:
-- All issues with the `untriaged` label are considered untriaged and close to product release, teams will be asked to triage them.
+- All issues with the `untriaged` label are considered untriaged and close to product release, teams will be asked to triage them. If they wish to tag them for a closer look later, they can use `needs further triage`.
 - During a release endgame and for servicing, issues and pull requests targeting a particular release will be asked to have a milestone set.
 # FAQ
 ## What designates a 'triaged' issue?
@@ -38,35 +36,37 @@ Marking issues with milestones is necessary during release endgame and servicing
 Pull requests for servicing should add the appropriate `major.minor.x` milestone (eg. `3.0.x`).  Once a specific servicing version is determined, the specific milestone will be added to the pull request (eg. `3.0.2`).
 
 It is generally acceptable to have issues without milestones, though this is left to the area owners to decide.  Said another way, not having a milestone does not mean that it is not triaged, see comment above.
+
+Prefer 3 element milestone names eg `3.0.0` not `3.0` to be consistent with other repos. This helps with reporting.
 ## How do you request a review for an issue/pull request if only 1 `area-*` label is applied?
 Labeling issues with more than 1 `area-*` label has been used to bring attention to the issue or pull request from multiple teams.  In order to ensure accountability we strive to only have 1 `area-*` label per issue and pull request.  In the event you need to bring the issue or pull request to multiple teams attention, please add them for review as opposed to adding their `area-*` label.
-## How will notifications work in dotnet/runtime?
-The default github notification system will be used for watching and tracking issue changes.  We will also be using GitHubIssues (https://github.com/karelz/GitHubIssues) to provide notifications as issues enter and exit areas that you subscribe to.
+## How do notifications work in dotnet/runtime?
+The default github notification system is used for watching and tracking issue changes. We also have a bot that sends notifications when an `area-*` label is applied. It does not automatically notify area owners; not everyone wants these notifications. Instead if you want these notification, see instructions in [area-owners.md](area-owners.md). It is not necessary to have committer rights to get them.
 ## How are pull requests marked with labels and milestones?
-Given the scope of dotnet/runtime, all pull requests will automatically be assigned an `area-*` label.  In addition, some pull requests may have milestones applied according to release endgame and servicing requirements.
+Given the scope of dotnet/runtime, all pull requests are automatically assigned an `area-*` label.  In addition, some pull requests may have milestones applied according to release endgame and servicing requirements.
 ## How do you do ongoing management for your repo?
-One team manager (M2) (perhaps rotating) will have accountability to ensuring the following global health activities will be accounted for:
+One team manager (M2) (perhaps rotating) has accountability to ensuring the following global health activities area accounted for:
 - Triaging incoming and assigning area-* labels to those that were not able to do automatically
 - Common infrastructure tracking
 - Service Level Agreement tracking for responsiveness and a healthy repo
 - Release issue burn down
 
 Area level owners will then manage their own pull requests and issues as they see fit.
-## How will labels be managed?
-There are few access controls, so in general everyone will have access - be a good global citizen.  When in doubt ask the team manager that is responsible.
-## What will be dotnet/runtime's branch policy?
+## What other issue automation is available?
+There is a `needs author feedback` label you can apply to an issue when it is not actionable without more information from the author. When this label is applied, if there is no subsequent comment from the author within 14 days, a bot adds the `no recent activity` label and a note. After a further 7 days without comment from the author the bot closes the issue or PR. If during any of this time there’s a comment from anyone, `no recent activity` is cleared. If there is a comment from the author, `needs author feedback` is also cleared and `needs further triage` is applied so we see it.
+## How are labels managed?
+There are few access controls, so in general everyone has access - be a good global citizen. It is possible to have too many labels. Consider whether a new label could be confusing: for example, a new `P1` label would be confusing given we already have priority labels. When in doubt ask the team manager that is responsible.
+## What is dotnet/runtime's branch policy?
 General guidance is to rarely create a direct branch within the repository and instead fork and create a branch.  If any branch is created temporarily, it should be deleted as soon as the associated pull request is merged or closed.  Any non-release branch is subject to deletion at any time.
 
 Branches are made for servicing releases and are managed centrally.  Merging into these branches is monitored and managed centrally.
 
-The repositories in dotnet/runtime represent the bottom of the stack for .NET Core.  As such, these repositories often lock down before the rest of .NET Core at the end of a release.  The general policy will be that all code within dotnet/runtime will align in their lockdown dates and policies.
+The repositories in dotnet/runtime represent the bottom of the stack for .NET Core.  As such, these repositories often lock down before the rest of .NET Core at the end of a release.  The general policy is that all code within dotnet/runtime will align in their lockdown dates and policies.
 ## What is dotnet/runtime's mirror policy?
 No specific policy.  But please use common sense if the mirror will have any potential impact on the broader community.
 ## What is dotnet/runtime's project boards and ZenHub policy?
 The portion of ZenHub that are shared across the entire repository is the names of the pipelines (eg. the column names).  As adding and editing these pipelines, it is best to communicate the broadly and build consensus.
 ## What is dotnet/runtime's policy on Wikis?
 Wikis will be disabled for this repository.
-## What is dotnet/runtime's policy on GitActions?
-GitActions will be disabled for this repository.