UNPKG

1.67 kBJavaScriptView Raw
1/**
2 * Used to group the {@link StandardTags} definitions according to the level of support
3 * expected from documentation tools that implement the standard.
4 */
5export var Standardization;
6(function (Standardization) {
7 /**
8 * TSDoc tags in the "Core" standardization group are considered essential.
9 * Their meaning is standardized, and every documentation tool is expected
10 * to recognize them. The TSDoc parser library typically provides dedicated APIs
11 * for accessing these tags.
12 */
13 Standardization["Core"] = "Core";
14 /**
15 * TSDoc tags in the "Extended" standardization group are optional. Documentation tools
16 * may or may not support them. If they do, the syntax and semantics should conform to
17 * the TSDoc standard definitions.
18 */
19 Standardization["Extended"] = "Extended";
20 /**
21 * TSDoc tags in the "Discretionary" standardization group are optional. Although the
22 * syntax is specified, the semantics for these tags are implementation-specific
23 * (and sometimes difficult to describe completely without referring to a specific
24 * implementation). Discretionary tags are included in the TSDoc standard to ensure that
25 * if two different popular tools use the same tag name, developers can expect the syntax
26 * to be the same, and the semantics to be somewhat similar.
27 */
28 Standardization["Discretionary"] = "Discretionary";
29 /**
30 * The tag is not part of the TSDoc standard. All used-defined tags are assigned to this group.
31 */
32 Standardization["None"] = "None";
33})(Standardization || (Standardization = {}));
34//# sourceMappingURL=Standardization.js.map
\No newline at end of file