-
Notifications
You must be signed in to change notification settings - Fork 11.9k
Update doc strings for command reference #12520
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
Conversation
6422d20 to
3b33311
Compare
| "description": "Opens the official Angular API documentation for a given keyword.", | ||
| "$longDescription": "", | ||
| "description": "Opens the Angular documentation in a browser, with a search for a given term.", | ||
| "$longDescription": "./doc.md, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
missing end quote
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
moved long desc back into short desc
| "description": "Generates and/or modifies files based on a schematic.", | ||
| "$longDescription": "", | ||
| "description": "Creates, initializes, and modifies files to create a generic version of an app or app element in the given or default project, according to the given schematic.", | ||
| "$longDescription": "Takes the name of the project, as specified in the \"projects\" section of the angular.json workspace configuration file. \n When a project name is not supplied, the configured default project of the workspace is used.", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The generate command actually doesn't take the name of a project in the same way as the other commands. It is currently an outlier and we've been discussing the best path forward to potentially remedy the situation.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
$longDescription also needs to point to a separate file.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
No long description now.
I'm also trying to formulate better boilerplate for the ones that do take an optional project. Maybe we can add it to definitions.json
fb6b2b9 to
b59817d
Compare
890b0f1 to
9ef0a14
Compare
|
This issue has been automatically locked due to inactivity. Read more about our automatic conversation locking policy. This action has been performed automatically by a bot. |
This is an initial draft transferring content from google doc draft to JSON sources.
Basic command descriptions and generation schematic options included.
This is to meant to test the git and cli-doc build process as well.