FAQ.md

@@ -159,7 +159,7 @@ As of Jun 2020, we've switched to `./bin/generate-samples.sh` for updating Petst
 
 `./bin/configs/other/` is another folder that stores the config files for generators that are less active.
 
-For Windows users, please run the script in [Git BASH](https://gitforwindows.org/)
+For Windows users, please run the script in [Git BASH](https://gitforwindows.org/).
 
 ### How to test with the latest master of OpenAPI Generator?
 
@@ -170,15 +170,20 @@ To test your OpenAPI/Swagger spec with the latest master to confirm whether the
 - Download the latest snapshot version of openapi-generator-cli JAR: https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/
 - Build the project locally
 
-1. git clone https://github.com/OpenAPITools/openapi-generator
-1. cd openapi-generator
-1. Build the project
-    1. `Windows`: mvnw.bat clean install
-    1. `Mac/Linux`: ./mvnw clean install
-1. Run the CLI jar locally
-    1. `Windows`: java -jar modules\openapi-generator-cli\target\openapi-generator-cli.jar generate -g ruby -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml -o C:\temp\ruby-client-test
-    1. `Mac/Linux`: java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate -g ruby -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml -o /var/tmp/ruby-client-test
-
+  1. `git clone https://github.com/OpenAPITools/openapi-generator`
+  2. `cd openapi-generator`
+  3. Build the project
+      - **Windows**: `mvnw.cmd clean install`
+      - **Mac/Linux**: `./mvnw clean install`
+  4. Run the CLI jar locally
+      - **Windows**:
+        ```sh
+        java -jar modules\openapi-generator-cli\target\openapi-generator-cli.jar generate -g ruby -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml -o C:\temp\ruby-client-test
+        ```
+      - **Mac/Linux**:
+        ```sh
+        java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate -g ruby -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml -o /var/tmp/ruby-client-test
+        ```
 
 ## git
 
@@ -186,14 +191,14 @@ To test your OpenAPI/Swagger spec with the latest master to confirm whether the
 
 Please refer to http://rypress.com/tutorials/git/rebasing, or follow the steps below (assuming the branch for the PR is "fix_issue_9999"):
 
-1. git checkout master
-2. git pull upstream master (assuming `upstream` is pointing to the official repo)
-3. git checkout fix_issue_9999
-4. git rebase master
-5. Resolve merge conflicts, if any, and run "git commit -a"
-6. Rebase done (you may need to add --force when doing `git push`)
+1. `git checkout master`
+2. `git pull upstream master` (assuming `upstream` is pointing to the official repo)
+3. `git checkout fix_issue_9999`
+4. `git rebase master`
+5. Resolve merge conflicts, if any, and run `git commit -a`
+6. Rebase done (you may need to add `--force` when doing `git push`)
 
-(To setup `upstream` pointing to the official repo, please run `git remote add upstream  https://github.com/openapitools/openapi-generator.git`)
+(To setup `upstream` pointing to the official repo, please run `git remote add upstream https://github.com/openapitools/openapi-generator.git`)
 
 ### How can I update commits that are not linked to my Github account?