Skip to content

Conversation

carlossanlop
Copy link
Contributor

Ported with DocsPortingTool.

Targeting the net6-rc1 branch.

@gewarren

This comment has been minimized.

<Docs>
<summary>To be added.</summary>
<summary>This attribute declares an API to be Preview and allows call sites to be flagged with a diagnostic indicating Preview API usage. Authors can use this attribute to ship Preview features in their assemblies.</summary>
<remarks>To be added.</remarks>
Copy link
Contributor Author

@carlossanlop carlossanlop Sep 3, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[Suggestion removed, I placed this in the wrong line. See the next line]

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: The link is not active yet, but will be by the time we ship.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change to type="Article"? Also, who is writing the documentation?

Copy link
Contributor Author

@carlossanlop carlossanlop Sep 8, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pgovind @tannergooding are you going to take care of this document? It should be up before we ship this: https://aka.ms/dotnet-warnings/preview-features

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've added the preview features properties to the MSBuild reference: https://docs.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props#enablepreviewfeatures. But I'll also plan to write a conceptual article.

@gewarren

This comment has been minimized.

@gewarren

This comment has been minimized.

<Docs>
<summary>To be added.</summary>
<summary>This attribute declares an API to be Preview and allows call sites to be flagged with a diagnostic indicating Preview API usage. Authors can use this attribute to ship Preview features in their assemblies.</summary>
<remarks>To be added.</remarks>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change to type="Article"? Also, who is writing the documentation?

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@opbld31
Copy link

opbld31 commented Sep 8, 2021

Docs Build status updates of commit c142d84:

✅ Validation status: passed

File Status Preview URL Details
xml/System.Runtime.Versioning/RequiresPreviewFeaturesAttribute.xml ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@pgovind
Copy link

pgovind commented Sep 8, 2021

Also, who is writing the documentation?

The docs team is my understanding, with me, @terrajobst and @jeffhandley helping. There's a design spec here: https://github.com/dotnet/designs/blob/main/accepted/2021/preview-features/preview-features.md. The
https://aka.ms/dotnet-warnings/preview-features link points to that page right now, but it'll need to come online at some point.

@carlossanlop carlossanlop merged commit 052bfc4 into dotnet:net6-rc1 Sep 8, 2021
@carlossanlop carlossanlop deleted the upd.versioning branch September 8, 2021 22:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants