From 995b713e3a034899d311fe7605963bd5b4c82e48 Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Tue, 16 Jan 2024 16:56:54 -0500 Subject: [PATCH] Update issue templates for .NET 9 (#39166) * first issue template edits * Update and reorder issue templates. * remove project check * add additional .NET 9 previews --- ...aking-change.yml => a-breaking-change.yml} | 11 +-- .github/ISSUE_TEMPLATE/b-docs-request.yml | 69 +++++++++++++++++++ ...re-csharp.yml => c-new-feature-csharp.yml} | 26 ++++--- .github/ISSUE_TEMPLATE/config.yml | 2 +- .github/ISSUE_TEMPLATE/doc-issue.md | 44 ------------ .github/ISSUE_TEMPLATE/docs-request.md | 24 ------- .../okr-internal-use-only-template.md | 37 ---------- ...r-feedback.yml => z-customer-feedback.yml} | 0 .repoman.yml | 7 -- 9 files changed, 95 insertions(+), 125 deletions(-) rename .github/ISSUE_TEMPLATE/{breaking-change.yml => a-breaking-change.yml} (95%) create mode 100644 .github/ISSUE_TEMPLATE/b-docs-request.yml rename .github/ISSUE_TEMPLATE/{new-feature-csharp.yml => c-new-feature-csharp.yml} (87%) delete mode 100644 .github/ISSUE_TEMPLATE/doc-issue.md delete mode 100644 .github/ISSUE_TEMPLATE/docs-request.md delete mode 100644 .github/ISSUE_TEMPLATE/okr-internal-use-only-template.md rename .github/ISSUE_TEMPLATE/{customer-feedback.yml => z-customer-feedback.yml} (100%) diff --git a/.github/ISSUE_TEMPLATE/breaking-change.yml b/.github/ISSUE_TEMPLATE/a-breaking-change.yml similarity index 95% rename from .github/ISSUE_TEMPLATE/breaking-change.yml rename to .github/ISSUE_TEMPLATE/a-breaking-change.yml index 14d5a5b882ec9..a16ca9e6e7e1f 100644 --- a/.github/ISSUE_TEMPLATE/breaking-change.yml +++ b/.github/ISSUE_TEMPLATE/a-breaking-change.yml @@ -21,15 +21,18 @@ body: label: Version description: What version of .NET introduced the breaking change? options: - - .NET 8 Preview 6 - - .NET 8 Preview 7 - - .NET 8 RC 1 - - .NET 8 RC 2 - .NET 8 GA - .NET 9 Preview 1 - .NET 9 Preview 2 - .NET 9 Preview 3 - .NET 9 Preview 4 + - .NET 9 Preview 5 + - .NET 9 Preview 6 + - .NET 9 Preview 7 + - .NET 9 RC 1 + - .NET 9 RC 2 + - .NET 9 RC 3 + - .NET 9 GA - Other (please put exact version in description textbox) validations: required: true diff --git a/.github/ISSUE_TEMPLATE/b-docs-request.yml b/.github/ISSUE_TEMPLATE/b-docs-request.yml new file mode 100644 index 0000000000000..1957affc15e3a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/b-docs-request.yml @@ -0,0 +1,69 @@ +name: "New article request" +description: Request a new article on a topic or concept that you can't find in our current docs. +title: "[New article]: " +body: + - type: markdown + attributes: + value: "## Request a new article" + - type: markdown + attributes: + value: "Describe the proposed new article for us." + - type: input + id: topic + attributes: + label: Proposed topic or title + description: Write a short title or description of the topic + validations: + required: true + - type: markdown + attributes: + value: > + "Propose a location for the article. Use the `/` character to + define 'sub-folders' in the table of contents. Start with a top-level + guide, and follow through to the parent folder for the new article." + - type: input + id: toc-item + attributes: + label: Location in table of Contents. + description: Give some indication for the location in the table of contents. + validations: + required: true + - type: markdown + attributes: + value: > + "Explain why the article is needed. What will readers learn? Why is + it important? What are the consequences if readers don't learn the topic?" + - type: textarea + id: motivation + attributes: + label: Reason for the article + description: Tell us why this article is needed. + validations: + required: true + - type: markdown + attributes: + value: > + "Write an opening paragraph or abstract to explain what readers + will learn from reading this article." + - type: textarea + id: abstract + attributes: + label: Article abstract + description: Write a *brief* abstract for the article. + validations: + required: true + - type: markdown + attributes: + value: > + "Tell us about searches you did looking for this inforamtion. This helps us + in two important ways. First, if the information exists, we can improve + the findability of the article for those search ideas. If the article + doesn't exist, this will help us make sure readers find it once it's written." + - type: textarea + id: searches + attributes: + label: Relevant searches + description: > + What search terms did you use to look for this information? + validations: + required: true \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/new-feature-csharp.yml b/.github/ISSUE_TEMPLATE/c-new-feature-csharp.yml similarity index 87% rename from .github/ISSUE_TEMPLATE/new-feature-csharp.yml rename to .github/ISSUE_TEMPLATE/c-new-feature-csharp.yml index f0f4b5301690a..81e1a39287ab2 100644 --- a/.github/ISSUE_TEMPLATE/new-feature-csharp.yml +++ b/.github/ISSUE_TEMPLATE/c-new-feature-csharp.yml @@ -1,8 +1,8 @@ -name: "C# 12 - New feature" +name: "C# 13 - New feature" description: Create the task list of a new feature in C# 12. Intended mostly for docs / product-team use. -title: "[C# 12]: New Feature - " +title: "[C# 13]: New Feature - " labels: - - ":checkered_flag: Release: .NET 8" + - ":checkered_flag: Release: .NET 9" - Pri1 - csharp-whats-new/tech - dotnet-csharp/prod @@ -15,10 +15,20 @@ body: label: Visual Studio release description: What Visual Studio (preview) contains this feature? options: - - "17.7" - - "17.8p1" - - "17.8p2" - - "17.8p3" + - "17.9p3" + - "17.9p4" + - "17.9p5" + - "17.9" + - "17.10p1" + - "17.10p2" + - "17.10p3" + - "17.10p4" + - "17.10p6" + - "17.10" + - "17.11p1" + - "17.11p2" + - "17.11p3" + - "17.11p4" - "Other (please put exact version in description textbox)" - type: input id: Speclet @@ -49,7 +59,7 @@ body: label: Areas affected description: Check all areas that must be updated. Some are always updated. options: - - label: "**Add to What's new in C# 12**: Add links to updated docs in the What's new in C# 12 article." + - label: "**Add to What's new in C# 13**: Add links to updated docs in the What's new in C# 12 article." required: true - label: "**Update language reference**: Detail the areas in the language reference that will be updated for this feature." required: true diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 14b0cb6e339b5..29429d85cc0a4 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,4 +1,4 @@ -blank_issues_enabled: true +blank_issues_enabled: false contact_links: - name: learn.microsoft.com site feedback url: https://github.com/MicrosoftDocs/feedback/issues/new/choose diff --git a/.github/ISSUE_TEMPLATE/doc-issue.md b/.github/ISSUE_TEMPLATE/doc-issue.md deleted file mode 100644 index dd2b642760f2e..0000000000000 --- a/.github/ISSUE_TEMPLATE/doc-issue.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -name: ".NET doc issue" -about: Report a problem in the .NET documentation -title: '' -labels: '' -assignees: '' - ---- - - - -**Issue description** - - - -**Target framework** - - - -- [ ] .NET Core -- [ ] .NET Framework -- [ ] .NET Standard - - - -
-dotnet --info output or About VS info - -```console - -``` -
diff --git a/.github/ISSUE_TEMPLATE/docs-request.md b/.github/ISSUE_TEMPLATE/docs-request.md deleted file mode 100644 index 2787c4d32036c..0000000000000 --- a/.github/ISSUE_TEMPLATE/docs-request.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -name: ".NET doc request" -about: Request a new article to provide missing information -title: '' -labels: '' -assignees: '' - ---- - -**Help us make content visible** - - - -**Describe the new article** - - diff --git a/.github/ISSUE_TEMPLATE/okr-internal-use-only-template.md b/.github/ISSUE_TEMPLATE/okr-internal-use-only-template.md deleted file mode 100644 index f8ef63590224e..0000000000000 --- a/.github/ISSUE_TEMPLATE/okr-internal-use-only-template.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -name: OKR internal use only template -about: This is the object key result (OKR) template, for internal use only. -title: 'OKR: address x, y, and z' -labels: OKR -assignees: '' - ---- - -<-- - -GOAL: -Each team has a commitment around content performance - -OBJECTIVES: - -- Content developers continue to get familiar with the Content Perf report by identifying and updating articles -- Create a sustainable and repeatable process. Each M1 has a project for content performance and tracks -- Continue to use data and feedback from past quarters to influence updates to formulas and ranking - -RESULTS: - -- Continue with 1 article per writer, per quarter -- % of page views to higher performing articles increases (targeted at 80% all up) - -TRACKING: - -- Use the [Azure DevOps template](https://dev.azure.com/mseng/TechnicalContent/_workitems/create/User%20Story) to create a tracking item - - Required: - - [ ] Includes tag "content-perf" and "FY21Q3" - - [ ] Set M1 and M2 fields - - [ ] Area path. Set to your team's path as you see fit -- Writers add "ms.custom: contperfq3" to their updated articles to help with data reporting. - -NOTE: For those teams that aren't currently using the [mseng TechnicalContent project](https://dev.azure.com/mseng/TechnicalContent), you'll still need to set up your items in it so we have an accurate inventory and ability to track. - ---> diff --git a/.github/ISSUE_TEMPLATE/customer-feedback.yml b/.github/ISSUE_TEMPLATE/z-customer-feedback.yml similarity index 100% rename from .github/ISSUE_TEMPLATE/customer-feedback.yml rename to .github/ISSUE_TEMPLATE/z-customer-feedback.yml diff --git a/.repoman.yml b/.repoman.yml index a030c492949a3..038b52f3bc727 100644 --- a/.repoman.yml +++ b/.repoman.yml @@ -45,13 +45,6 @@ issues: pass: - labels-add: ["source incompatible"] - # Add to .NET 6 project if .NET 6 label added - - check: - - type: query - value: "length(Issue.labels[?name == ':checkered_flag: Release: .NET 6']) != `0`" - pass: - - projects-add: [132] - opened: # New issue opened, add Not Triaged - labels-add: [":watch: Not Triaged"]