Fix minor issues in sanitations.md

docs/spec/sanitations.md

@@ -6,9 +6,9 @@ _Edition_: Swan Lake
 # Sanitation for OpenAPI specification
 
 This document records the sanitation done on top of the official OpenAPI specification from Slack. The OpenAPI specification is obtained from the [APIs Guru website](https://api.apis.guru/v2/specs/slack.com/1.7.0/openapi.json).
-The following changes were made so as to prevent api methods demanding a token being passed as a method parameter.
+These changes are done in order to improve the overall usability, and to address some known language limitations.
 
-1. Remove the token requirement from the parameter section of each endpoint in which it appeared. Endpoints in which it did not appear are:-
+1. Removed the token requirement from the parameter section of each endpoint in which it appeared. Endpoints in which it did not appear are:-
 
         admin.conversations.restrictAccess.addGroup
         admin.conversations.restrictAccess.removeGroup
@@ -31,8 +31,10 @@ The following changes were made so as to prevent api methods demanding a token b
 
 ## OpenAPI cli command
 
-The following command was used to generate the Ballerina client from the OpenAPI specification. The command should be executed from the repository '/ballerina' directory.
+The following command was used to generate the Ballerina client from the OpenAPI specification. The command should be executed from the repository root directory.
 
 ```bash
-bal openapi -i ..\docs\spec\openapi.json --mode client --license ..\docs\license.txt
-```
+bal openapi -i docs/spec/openapi.json --mode client --license docs/license.txt -o ballerina/
+```
+
+Note: The license year is hardcoded to 2024, change if necessary.