github-mirrors/kibana
1
0
Fork 0
mirror of https://github.com/elastic/kibana.git synced 2025-06-28 11:05:39 -04:00
Code Issues Projects Releases Packages Wiki Activity

Update best_practices.mdx (#98032)

Browse source
This commit is contained in:
Stacey Gammon 2021-04-27 16:50:39 -04:00 • committed by GitHub
parent 942243158d
commit 1a1c36a99b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 1 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
dev_docs/best_practices.mdx
View file

@ -65,6 +65,7 @@ Every publicly exposed function, class, interface, type, parameter and property
- Use `@returns` tags for return types. - Use `@returns` tags for return types.
- Use `@throws` when appropriate. - Use `@throws` when appropriate.
- Use `@beta` or `@deprecated` when appropriate. - Use `@beta` or `@deprecated` when appropriate.
- Use `@removeBy {version}` on `@deprecated` APIs. The version should be the last version the API will work in. For example, `@removeBy 7.15` means the API will be removed in 7.16. This lets us avoid mid-release cycle coordination. The API can be removed as soon as the 7.15 branch is cut.
- Use `@internal` to indicate this API item is intended for internal use only, which will also remove it from the docs. - Use `@internal` to indicate this API item is intended for internal use only, which will also remove it from the docs.
#### Interfaces vs inlined types #### Interfaces vs inlined types