Skip to content

Commit e7f73d5

Browse files
committed
Add a link to Experimental features from Preview APIs
1 parent 0e0581e commit e7f73d5

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

docs/fundamentals/apicompat/preview-apis.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,8 @@ When building against an experimental API, the compiler will produce an error. E
5454

5555
Since each experimental feature has a separate ID, consenting to using one experimental feature doesn't consent to using another.
5656

57+
For more information, see [Experimental features][experimental-overview].
58+
5759
## Choose between the options
5860

5961
Library developers should only use prerelease NuGet packages or mark APIs with `[Experimental]`:
@@ -67,3 +69,4 @@ The `[RequiresPreviewFeatures]` attribute is only meant for components of the .N
6769
The exception to this rule is if you're building a stable library and want to expose certain features that in turn depend on runtime or language preview behaviors. In that case you should use `[RequiresPreviewFeatures]` for the entry points of that feature. However, you need to consider that users of such APIs have to turn on preview features too, which exposes them to all runtime, library, and language preview behaviors.
6870

6971
[choosing-diagnostic-ids]: ../../csharp/roslyn-sdk/choosing-diagnostic-ids.md
72+
[experimental-overview]: ../syslib-diagnostics/experimental-overview.md

0 commit comments

Comments
 (0)