mirror of
https://github.com/dotnet/skills.git
synced 2026-09-20 09:49:54 +08:00
Dan Moseley
042a9d2b2c
* Reorganize plugins per agreed structure (#271) Split the dotnet plugin into domain-specific plugins per discussion in #271: - dotnet: narrowed to common everyday C#/.NET coding tasks - dotnet-diag: perf investigations, debugging, incident analysis - dotnet-data: data access and Entity Framework - dotnet-aspnet, dotnet-wpf, dotnet-winforms, dotnet-maui: scaffolded empty to convey intent for future framework-specific skills Moved skills, tests, and CODEOWNERS entries accordingly. No file content was changed; all skill/test moves are pure renames. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Improve dotnet-diag and dotnet-winforms descriptions - dotnet-diag: add '.NET' qualifier to clarify scope - dotnet-winforms: use official 'Windows Forms (WinForms)' name Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add .NET qualifier to dotnet-data description Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Remove empty plugins; list them in CONTRIBUTING.md as future options Remove the four empty placeholder plugins (dotnet-aspnet, dotnet-wpf, dotnet-winforms, dotnet-maui) that had only plugin.json and no skills. Add a 'Plugin organization' section to CONTRIBUTING.md that describes the domain-specific plugin groupings introduced in this PR and lists the four removed plugin names as reserved candidates for future contributions. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Create dotnet-upgrade plugin with migration/upgrade skills Move migrate-nullable-references, thread-abort-migration, and dotnet-aot-compat from dotnet to the new dotnet-upgrade plugin. Update CODEOWNERS paths (same owners), CONTRIBUTING.md plugin table, and fix the thread-abort-migration SKILL.md link in CONTRIBUTING.md. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
61 lines
2.7 KiB
C#
61 lines
2.7 KiB
C#
// Copyright (c) Microsoft Corporation. All rights reserved.
|
|
// Licensed under the MIT License.
|
|
|
|
#if !NET8_0_OR_GREATER
|
|
|
|
#nullable enable
|
|
|
|
namespace System.Diagnostics.CodeAnalysis
|
|
{
|
|
/// <summary>
|
|
/// Indicates that an API is experimental and it may change in the future.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This attribute allows call sites to be flagged with a diagnostic that indicates that an experimental
|
|
/// feature is used. Authors can use this attribute to ship preview features in their assemblies.
|
|
/// </remarks>
|
|
[AttributeUsage(AttributeTargets.Assembly |
|
|
AttributeTargets.Module |
|
|
AttributeTargets.Class |
|
|
AttributeTargets.Struct |
|
|
AttributeTargets.Enum |
|
|
AttributeTargets.Constructor |
|
|
AttributeTargets.Method |
|
|
AttributeTargets.Property |
|
|
AttributeTargets.Field |
|
|
AttributeTargets.Event |
|
|
AttributeTargets.Interface |
|
|
AttributeTargets.Delegate, Inherited = false)]
|
|
internal sealed class ExperimentalAttribute : Attribute
|
|
{
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="ExperimentalAttribute"/> class, specifying the ID that the compiler will use
|
|
/// when reporting a use of the API the attribute applies to.
|
|
/// </summary>
|
|
/// <param name="diagnosticId">The ID that the compiler will use when reporting a use of the API the attribute applies to.</param>
|
|
public ExperimentalAttribute(string diagnosticId)
|
|
{
|
|
DiagnosticId = diagnosticId;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the ID that the compiler will use when reporting a use of the API the attribute applies to.
|
|
/// </summary>
|
|
/// <value>The unique diagnostic ID.</value>
|
|
/// <remarks>
|
|
/// The diagnostic ID is shown in build output for warnings and errors.
|
|
/// <para>This property represents the unique ID that can be used to suppress the warnings or errors, if needed.</para>
|
|
/// </remarks>
|
|
public string DiagnosticId { get; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the URL for corresponding documentation.
|
|
/// The API accepts a format string instead of an actual URL, creating a generic URL that includes the diagnostic ID.
|
|
/// </summary>
|
|
/// <value>The format string that represents a URL to corresponding documentation.</value>
|
|
/// <remarks>An example format string is <c>https://contoso.com/obsoletion-warnings/{0}</c>.</remarks>
|
|
public string? UrlFormat { get; set; }
|
|
}
|
|
}
|
|
#endif
|