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

[Typescript-Angular2] add @summary JSDoc tag #6028

Merged
merged 3 commits into from
Jul 13, 2017
Merged

[Typescript-Angular2] add @summary JSDoc tag #6028

merged 3 commits into from
Jul 13, 2017

Conversation

isman-usoh
Copy link
Contributor

@isman-usoh isman-usoh commented Jul 12, 2017

PR checklist

  • Read the contribution guidelines.
  • Ran the shell/batch script under ./bin/ to update Petstore sample so that CIs can verify the change. (For instance, only need to run ./bin/{LANG}-petstore.sh and ./bin/security/{LANG}-petstore.sh if updating the {LANG} (e.g. php, ruby, python, etc) code generator or {LANG} client's mustache templates)
  • Filed the PR against the correct branch: master for non-breaking changes and 2.3.0 branch for breaking (non-backward compatible) changes.

Description of the PR

add @summary JSDoc tag for api method

java %JAVA_OPTS% -jar %executable% %ags%

echo "Typescript Petstore API client (with interfaces generated)"
set ags=generate -i modules/swagger-codegen/src/test/resources/2_0/petstore.yaml -l typescript-angular2 -o samples/client/petstore/typescript-angular2/with-interfaces -D withInterfaces=true
Copy link
Contributor

Choose a reason for hiding this comment

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

@isman-usoh thanks for creating this batch file. Shall we use "" instead of "/"?

* {{notes}}
{{#summary}}* @summary {{&summary}}{{/summary}}
Copy link
Contributor

Choose a reason for hiding this comment

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

Given that summary is not a required field in the spec, I think the above may result in empty line with 4 leading spaces. What about using the following instead?

    {{#summary}}
    * @summary {{&summary}}
    {{/summary}}

@wing328 wing328 merged commit fdaf8ea into swagger-api:master Jul 13, 2017
@wing328
Copy link
Contributor

wing328 commented Jul 13, 2017

@isman-usoh thanks for the enhancement, which has been merged into master.

FYI. In 2.3.0 branch (with breaking changes), we've renamed typescript-angular to typescript-angularjs and typescript-angular2 to typescript-angular.

@wing328
Copy link
Contributor

wing328 commented Jul 13, 2017

FYI. #6052 submitted for other TS generators (e.g. node, jquery, fetch, etc)

@isman-usoh isman-usoh deleted the typescript-angular2-jsdoc branch July 16, 2017 06:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants