Skip to content

Commit

Permalink
Set policy for stale / abandoned PRs
Browse files Browse the repository at this point in the history
Fixes #42438

The substantive changes are to add a policy statement on closing stale or abandoned PRs to the readme.md.

Other changes are to remove files that were placeholders, and to update links to the appropriate location in the public contributor guide.
  • Loading branch information
BillWagner committed Sep 17, 2024
1 parent fadc18d commit f66a16c
Show file tree
Hide file tree
Showing 6 changed files with 9 additions and 19 deletions.
17 changes: 8 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,24 +11,23 @@

This repository contains the conceptual documentation for .NET. The [.NET documentation site](https://learn.microsoft.com/dotnet) is built from multiple repositories in addition to this one:

- [.NET Desktop workloads](https://github.com/dotnet/docs-desktop)
- [.NET Aspire](https://github.com/dotnet/docs-aspire)
- [.NET Desktop workloads](https://github.com/dotnet/docs-desktop)
- [API reference](https://github.com/dotnet/dotnet-api-docs)
- [.NET Compiler Platform SDK reference](https://github.com/dotnet/roslyn-api-docs)
- [C# specification - draft](https://github.com/dotnet/csharpstandard)
- [C# Language design](https://github.com/dotnet/csharplang)
- [C# specification - draft](https://github.com/dotnet/csharpstandard)

Our team's tasks are tracked in our [project boards](https://github.com/dotnet/docs/projects?query=is%3Aopen). You'll see monthly sprint projects, along with long-running projects for major documentation updates. The projects contain documentation issues across the repositories that build .NET docs. Issues are tracked in the relevant repositories. We have a large community using these resources. We make our best effort to respond to issues in a timely fashion. You can read more about our procedures for classifying and resolving issues in our [Issues policy](issues-policy.md) topic. To create a new issue, click the "Open a documentation issue" button at the bottom of any of our published docs, or [choose one of the available templates](https://github.com/dotnet/docs/issues/new/choose). The control at the bottom of each article automatically routes you to the correct repo and fills in some relevant information based on the article.
Our team's tasks are tracked in our [project boards](https://github.com/dotnet/docs/projects?query=is%3Aopen). You'll see monthly sprint projects, along with long-running projects for major documentation updates. The projects contain documentation issues across the repositories that build .NET docs. Issues are tracked in the relevant repositories. We have a large community using these resources. We make our best effort to respond to issues in a timely fashion. To create a new issue, click the "Open a documentation issue" button at the bottom of any of our published docs, or [choose one of the available templates](https://github.com/dotnet/docs/issues/new/choose). The control at the bottom of each article automatically routes you to the correct repo and fills in some relevant information based on the article.

## :purple_heart: Contribute

We welcome contributions to help us improve and complete the .NET docs. This is a very large repo, covering a large area. If this is your first visit, see our [labels and projects roadmap](styleguide/labels-projects.md) for help navigating the issues and projects in this repository. If your contribution includes third-party dependencies, see our guidance on using [third-party dependencies](styleguide/3rdPartyDependencies.md).
We welcome contributions to help us improve and complete the .NET docs. This is a very large repo, covering a large area. If this is your first visit, see the [Contributor guide](https://learn.microsoft.com/contribute/content/dotnet/dotnet-contribute) for information on working with us. Look for issues labeled [`help wanted` :label:](https://github.com/dotnet/docs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22+) for ideas to get started.

Before submitting a PR with 3rd party dependencies, see our policy on [3rd party dependencies](admin/3rdPartyDependencies.md).

To contribute, see:
We work to merge or close PRs in a timely fashion. We regularly review and approve PRs. We encourage contributors to respond to comments in a similar timely fashion. Many times, reviews identify small changes such as spelling or grammar issues, or word choice. Maintainers can accept those suggestions and merge the PR. In other situations, maintainers ask for more significant changes before a PR is ready to merge. We expect contributors to make those changes. Maintainers will help by answering questions or pointing to other resources, if needed.

- The [.NET Contributor Guide :ledger:](https://learn.microsoft.com/contribute/dotnet/dotnet-contribute) for instructions on procedures we use.
- Issues labeled [`help wanted` :label:](https://github.com/dotnet/docs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22+) for ideas.
- [#Hacktoberfest and Microsoft Docs :jack_o_lantern:](https://learn.microsoft.com/contribute/hacktoberfest) for details on our participation in the annual event.
We consider PRs to be abandoned when they've had no activity (either commits or discussion) in the past 30 days. Team members will close PRs that have been abandoned. Contributors can reopen and continue to work.

## :bookmark_tabs: Code of conduct

Expand Down
File renamed without changes.
2 changes: 1 addition & 1 deletion admin/governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ You can see the full details on configured GitHub actions in our [README.MD](htt

## :ledger: Labels for reporting

- `*/tech`, `*/prod`: These labels provide 1st and 2nd level organization to our content.
- `*/subsvc`, `*/svc`: These labels provide 1st and 2nd level organization to our content.
- `doc-*`, `product-*`: These provide classifications for what kind of issue is it.
- `okr-*`: These map to our internal OKR system.

Expand Down
3 changes: 0 additions & 3 deletions styleguide/labels-projects.md

This file was deleted.

3 changes: 0 additions & 3 deletions styleguide/template.md

This file was deleted.

3 changes: 0 additions & 3 deletions styleguide/voice-tone.md

This file was deleted.

0 comments on commit f66a16c

Please sign in to comment.