Apply text suggestions from code review

Co-authored-by: Juliet Shackell <63259011+jshackell-sfdc@users.noreply.github.com>

Author: ad-shreya

messages/devops.project.list.md

@@ -4,18 +4,18 @@ List all DevOps Center projects in a Salesforce org.
 
 # description
 
-Lists all DevOps Center projects available in the specified org by querying the DevopsProject object. Returns project Id, Name, and Description for each project found.
+This command queries the DevopsProject standard object and returns the project Id, Name, and Description for each project found.
 
 # flags.target-org.summary
 
 Username or alias of the DevOps Center org.
 
 # examples
 
-- List all DevOps Center projects in an org.
+- List all DevOps Center projects in an org with alias "my-devops-org":
 
       <%= config.bin %> <%= command.id %> --target-org my-devops-org
 
-- List projects using a username.
+- List projects using an org's username:
 
       <%= config.bin %> <%= command.id %> --target-org devops-center@example.com

messages/devops.work-item.create.md

@@ -4,7 +4,7 @@ Create a new work item in a DevOps Center project.
 
 # description
 
-Creates a new DevOps Center work item in the specified project using the Connect API. Requires a project ID (obtainable from `sf devops project list`) and a subject for the work item.
+The command creates the work item using the Connect API. Requires a project ID and a subject for the new work item; run the `devops project list` command to get the IDs for all existing projects. 
 
 # flags.target-org.summary
 
@@ -28,6 +28,6 @@ Description of the new work item.
 
       <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 0Hn000000000001 --subject "Fix login bug"
 
-- Create a work item with a subject and description.
+- Create a work item with a subject and description:
 
       <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 0Hn000000000001 --subject "Add dark mode" --description "Implement dark mode toggle in settings page"

messages/devops.work-item.list.md

@@ -4,7 +4,7 @@ List all work items for a DevOps Center project.
 
 # description
 
-Lists work items from a Salesforce DevOps Center project. Each work item includes branch, environment, and repository details needed for checkout and promotion. Requires a project ID which can be obtained from `sf devops project list`.
+Each work item displays the branch, environment, and repository details needed for checkout and promotion. Requires a project ID; run the `devops project list` command to get the IDs for all existing projects.  
 
 # flags.target-org.summary
 
@@ -16,10 +16,10 @@ ID of the DevOps Center project to list work items for.
 
 # examples
 
-- List work items for a specific project.
+- List work items for a specific project in the DevOps org with alias "my-devops-org":
 
       <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 0Hn000000000001
 
-- List work items with JSON output.
+- List work items using JSON output:
 
       <%= config.bin %> <%= command.id %> --target-org my-devops-org --project-id 0Hn000000000001 --json