1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-21 15:04:11 -05:00

refactor(docs): use @experimental instead of @tags unstable (#23884)

This commit is contained in:
Leo Kettmeir 2024-05-22 04:31:51 -07:00 committed by GitHub
parent fabd9a214b
commit 7ab7a14db7
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 336 additions and 332 deletions

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -7,7 +7,7 @@
/**
* @category Messaging
* @tags unstable
* @experimental
*/
declare interface BroadcastChannelEventMap {
"message": MessageEvent;
@ -16,7 +16,7 @@ declare interface BroadcastChannelEventMap {
/**
* @category Messaging
* @tags unstable
* @experimental
*/
declare interface BroadcastChannel extends EventTarget {
/**
@ -59,7 +59,7 @@ declare interface BroadcastChannel extends EventTarget {
/**
* @category Messaging
* @tags unstable
* @experimental
*/
declare var BroadcastChannel: {
readonly prototype: BroadcastChannel;

View file

@ -1463,7 +1463,7 @@ fn lsp_hover_asset() {
"value": "interface Date",
},
"Enables basic storage and retrieval of dates and times.",
"\n\n*@category* - Temporal \n\n*@tags* - unstable"
"\n\n*@category* - Temporal \n\n*@experimental*"
],
"range": {
"start": { "line": 111, "character": 10, },
@ -2039,7 +2039,7 @@ fn lsp_hover_unstable_always_enabled() {
"value":"interface Deno.ForeignLibraryInterface"
},
"**UNSTABLE**: New API, yet to be vetted.\n\nA foreign library interface descriptor.",
"\n\n*@category* - FFI \n\n*@tags* - unstable",
"\n\n*@category* - FFI \n\n*@experimental*",
],
"range":{
"start":{ "line":0, "character":14 },
@ -2084,7 +2084,7 @@ fn lsp_hover_unstable_enabled() {
"value":"interface Deno.ForeignLibraryInterface"
},
"**UNSTABLE**: New API, yet to be vetted.\n\nA foreign library interface descriptor.",
"\n\n*@category* - FFI \n\n*@tags* - unstable",
"\n\n*@category* - FFI \n\n*@experimental*",
],
"range":{
"start":{ "line":0, "character":14 },

View file

@ -70,14 +70,8 @@ for (const file of project.getSourceFiles()) {
}
if (unstableFiles.includes(file)) {
const tagsTag = tags.find((tag) => tag.getTagName() === "tags");
if (
!(tagsTag?.getComment() &&
tagsTag.getCommentText().includes("unstable"))
) {
errors.push(
getErrorPrefix(node) + "JSDoc @tags tag with value 'unstable'",
);
if (!tags.find((tag) => tag.getTagName() === "experimental")) {
errors.push(getErrorPrefix(node) + "JSDoc @experimental tag");
}
}
}