Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add more standard tag definitions #50

Merged
merged 14 commits into from
Aug 24, 2018
Merged

Add more standard tag definitions #50

merged 14 commits into from
Aug 24, 2018

Conversation

octogonz
Copy link
Collaborator

@octogonz octogonz commented Aug 23, 2018

Rename the CoreTags API to StandardTags and introduce a distinction between "core", "extended", and "discretionary" standard tags.

NOTE: This library is still in a preliminary implementation phase. Although these tags are designated as "standard", the syntax/semantics are open to discussion. If you'd like to propose improvements, please open a GitHub issue!

* Example implementations: API Extractor
*/
public static readonly internalRemarks: TSDocTagDefinition = StandardTags._defineTag({
tagName: '@internalRemarks',
Copy link
Member

@iclanton iclanton Aug 23, 2018

Choose a reason for hiding this comment

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

internal [](start = 15, length = 8)

@privateRemarks? #Resolved

*
* Example implementations: API Extractor
*/
public static readonly preapproved: TSDocTagDefinition = StandardTags._defineTag({
Copy link
Member

@iclanton iclanton Aug 23, 2018

Choose a reason for hiding this comment

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

preapproved [](start = 25, length = 11)

This is too obscure to be in the standard. #Resolved

StandardTags.param,
StandardTags.readonly,
StandardTags.remarks,
StandardTags.returns
Copy link
Member

@iclanton iclanton Aug 23, 2018

Choose a reason for hiding this comment

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

There are a few missing here. #Resolved

Copy link
Member

@iclanton iclanton left a comment

Choose a reason for hiding this comment

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

:shipit:

@octogonz octogonz merged commit 5c24dd8 into master Aug 24, 2018
@octogonz
Copy link
Collaborator Author

This PR was published as @microsoft/tsdoc version 0.2.0.

@octogonz octogonz deleted the pgonzal/standard-tags branch August 24, 2018 00:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants