diff --git a/README.md b/README.md index 1b0abbc47e1e9..6add5f64579d1 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/styleguide/3rdPartyDependencies.md b/admin/3rdPartyDependencies.md similarity index 100% rename from styleguide/3rdPartyDependencies.md rename to admin/3rdPartyDependencies.md diff --git a/admin/governance.md b/admin/governance.md index 3611b621b4bfe..e85684a03696d 100644 --- a/admin/governance.md +++ b/admin/governance.md @@ -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. diff --git a/styleguide/labels-projects.md b/styleguide/labels-projects.md deleted file mode 100644 index 728b6f4ad2367..0000000000000 --- a/styleguide/labels-projects.md +++ /dev/null @@ -1,3 +0,0 @@ -# Labels and projects - -This content has been moved to the [Contributor guide](https://learn.microsoft.com/contribute/dotnet/labels-projects). diff --git a/styleguide/template.md b/styleguide/template.md deleted file mode 100644 index 667f944495508..0000000000000 --- a/styleguide/template.md +++ /dev/null @@ -1,3 +0,0 @@ -# Article template - -This content has been moved to the [Contributor guide](https://learn.microsoft.com/contribute/dotnet-style-guide). diff --git a/styleguide/voice-tone.md b/styleguide/voice-tone.md deleted file mode 100644 index 0c3b7b1ac6ecd..0000000000000 --- a/styleguide/voice-tone.md +++ /dev/null @@ -1,3 +0,0 @@ -# Voice and tone recommendations - -This content has been moved to the [Contributor guide](https://learn.microsoft.com/contribute/dotnet/dotnet-voice-tone).