AWS amazonq documentation change
Summary
Updated documentation to replace '/dev' command references with natural language interactions using Amazon Q for feature development
Security assessment
Changes focus on user interaction patterns rather than security mechanisms. The removal of '/dev' command syntax and emphasis on natural language requests appears to be a usability improvement rather than a security fix. While the example mentions JWT token authentication (a security feature), this is existing functionality documentation rather than new security guidance.
Diff
diff --git a/amazonq/latest/qdeveloper-ug/software-dev.md b/amazonq/latest/qdeveloper-ug/software-dev.md index 1e0002a61..78a67868a 100644 --- a//amazonq/latest/qdeveloper-ug/software-dev.md +++ b//amazonq/latest/qdeveloper-ug/software-dev.md @@ -5 +5 @@ -Develop features with /devBest practicesExample tasksQuotas +Develop features with Amazon QBest practicesExample tasksQuotas @@ -11 +11 @@ Develop features with /devBest practicesExample tasksQuotas -You can ask for help with feature development directly in the chat. If you use /dev, your request will be redirected to the chat. +You can ask for help with feature development directly in the chat using natural language requests. @@ -24 +24 @@ You can start an entirely new project, or work on an open project in your IDE. W -To get started, open up a new or existing project and enter `/dev` in the Amazon Q chat panel. A new chat tab opens where you interact with Amazon Q to generate new code for your feature. +To get started, open up a new or existing project and ask Amazon Q to help develop a feature in the chat panel. A new chat tab opens where you interact with Amazon Q to generate new code for your feature. @@ -28 +28 @@ To get started, open up a new or existing project and enter `/dev` in the Amazon - * Develop features with /dev + * Develop features with Amazon Q @@ -36 +36 @@ To get started, open up a new or existing project and enter `/dev` in the Amazon - * [Testing code suggestions generated by the Amazon Q '/dev' command](./devfile.html) + * [Testing code suggestions generated by Amazon Q feature development](./devfile.html) @@ -43 +43 @@ To get started, open up a new or existing project and enter `/dev` in the Amazon -## Develop features with `/dev` +## Develop features with Amazon Q @@ -47 +47 @@ To get started, open up a new or existing project and enter `/dev` in the Amazon -You can ask for help with feature development directly in the chat. If you use /dev, your request will be redirected to the chat. +You can ask for help with feature development directly in the chat using natural language requests. @@ -55 +55 @@ To work on a code task with Amazon Q in your IDE, complete the following steps. - 3. Enter `/dev` in the Amazon Q chat panel followed by a description of the task you want to accomplish or the issue you want to resolve. You can provide a brief overview of a task, or add more details. Amazon Q uses your description and the code in your project to generate code. + 3. Ask Amazon Q to help develop a feature by describing the task you want to accomplish or the issue you want to resolve. You can provide a brief overview of a task, or add more details. Amazon Q uses your description and the code in your project to generate code. @@ -59,3 +59 @@ Following is an example of a code change you can ask Amazon Q to implement: -`/dev Create a new REST API endpoint /api/authenticate to handle user authentication. This endpoint should accept POST requests with user credentials and return a JWT token upon successful authentication. Additionally, update the user management system to integrate with the new authentication endpoint and enforce authentication for relevant API endpoints.` - -You can also enter `/dev` only to see example tasks. +`Create a new REST API endpoint /api/authenticate to handle user authentication. This endpoint should accept POST requests with user credentials and return a JWT token upon successful authentication. Additionally, update the user management system to integrate with the new authentication endpoint and enforce authentication for relevant API endpoints.` @@ -69 +67 @@ If you want Amazon Q to stop generating code, choose **Stop**. The incomplete co -Optionally, Amazon Q can test its code suggestions in a separate dev environment before presenting them to you in the chat window. For more information, see [Testing '/dev' suggestions](./devfile.html). +Optionally, Amazon Q can test its code suggestions in a separate dev environment before presenting them to you in the chat window. For more information, see [Testing feature development suggestions](./devfile.html). @@ -150 +148 @@ Troubleshooting -Testing '/dev' suggestions +Testing feature development suggestions