feat(docs): updated docs content

Author: akhilmhdh

docs/docs/cli/cli-commands/apic-help.md

@@ -1 +1,17 @@
-# APIC Help
+# Util commands
+
+## APIC help
+
+To get cli help over various commands
+
+```bash
+apic help
+```
+
+## Version
+
+To get the current version of APIC cli
+
+```bash
+apic --version
+```

docs/docs/cli/cli-commands/apic-run.md

@@ -1 +1,12 @@
 # APIC Run
+
+To run APIC cli validation against the api schema file
+
+## Options
+
+| Name    | Flag | Desc                                             | Required | Type            | Default |
+| ------- | ---- | ------------------------------------------------ | -------- | --------------- | ------- |
+| apiType | -a   | API schema type                                  | true     | Enum[ openapi ] | -       |
+| schema  |      | URL or local file containing the API schema file | true     | String          | -       |
+| config  |      | path to apic config file                         | false    | String          | ./apic  |
+| export  |      | export the final report to the given directory   | false    | String          | -       |

docs/docs/cli/installation.md

@@ -5,12 +5,20 @@ import TabItem from '@theme/TabItem';
 
 <Tabs>
 <TabItem value="mac" label="MacOS" default>
-Use <a>brew</a> package manaager
+Use <a>brew</a> package manager
 <br/>
 <br/>
 
+Add the 1-platform brew tap
+
 ```bash
-brew install one-platform/apic
+brew tap 1-platform/homebrew-tools
+```
+
+Now you can install the CLI
+
+```bash
+brew install 1-platform/apic
 ```
 
 </TabItem>
@@ -19,31 +27,99 @@ We use cloudsmith to distribute packages
 <br/>
 <br/>
 
+Add 1-platform cloudsmith repo url to your package manager
+
 ```bash
+apk add --no-cache bash curl
+
 curl -1sLf \
-  'https://dl.cloudsmith.io/public/OWNER/REPOSITORY/cfg/setup/bash.deb.sh' \
-  | sudo bash
+  'https://dl.cloudsmith.io/public/1-platform/apic/cfg/setup/bash.alpine.sh' \
+  | bash
+```
+
+Now you can install the CLI
+
+```bash
+apk add apic --update-cache
 ```
 
 </TabItem>
-<TabItem value="deb" label="Debian/Ubuntu">
+
+<TabItem value="deb" label="Debian/Ubuntu" >
 We use cloudsmith to distribute packages
 <br/>
 <br/>
 
+Add 1-platform cloudsmith repo url to your package manager
+
 ```bash
+apt-get update && apt-get install -y bash curl
+
 curl -1sLf \
-  'https://dl.cloudsmith.io/public/OWNER/REPOSITORY/cfg/setup/bash.deb.sh' \
-  | sudo bash
+  'https://dl.cloudsmith.io/public/1-platform/apic/cfg/setup/bash.deb.sh' \
+  | bash
+```
+
+Now you can install the CLI
+
+```bash
+apt-get update && apt-get install -y apic
 ```
 
 </TabItem>
+
+<TabItem value="linux" label="RedHat/Amazon-Linux" >
+We use cloudsmith to distribute packages
+<br/>
+<br/>
+
+Add 1-platform cloudsmith repo url to your package manager
+
+```bash
+curl -1sLf \
+  'https://dl.cloudsmith.io/public/1-platform/apic/cfg/setup/bash.rpm.sh' \
+  | sh
+```
+
+Now you can install the CLI
+
+```bash
+yum install apic
+```
+
+If your a fedora user
+
+```bash
+dnf install apic
+```
+
+</TabItem>
+
+<TabItem value="widows" label="Windows" >
+We use scoop to distribute packages
+<br/>
+<br/>
+
+Add 1-platform scoop repo url
+
+```bash
+scoop bucket add https://github.com/1-Platform/scoop-tools
+```
+
+Now you can install the CLI
+
+```bash
+scoop install apic
+```
+
+</TabItem>
+
 </Tabs>
 
 To make sure it's installed correctly you can run
 
 ```bash
-apic help
+apic --version
 ```
 
 ### Run against an OpenAPI

docs/docs/cli/modules/env.md

@@ -1 +1,21 @@
 # Env Module
+
+Env module can be imported from `apic/env` to set and get environment variabls.
+
+## Functions
+
+### setEnv
+
+```js
+import { setEnv } from "apic/env";
+
+setEnv("key", "value");
+```
+
+### getEnv
+
+```js
+import { getEnv } from "apic/env";
+
+const envValue = getEnv("key");
+```

docs/docs/cli/modules/exec.md

@@ -1 +1,17 @@
 # Exec Module
+
+Exec module can be imported from `apic/exec` to execute system commands.
+
+## Functions
+
+### cmd
+
+```js
+import cmd from "apic/exec";
+
+const { data, error } = cmd("....");
+```
+
+This will execute a system command.
+
+Data key contains system output and error key contains the stderr

docs/docs/cli/modules/overview.md

@@ -1 +1,26 @@
+---
+sidebar_position: 1
+---
+
 # Overview
+
+APIC comes with some JS modules to help you write your own rule.
+
+You can import those packages under the `apic/` namespace.
+
+List of APIC modules
+
+| Name                                   | Package      | Desc                                 |
+| -------------------------------------- | ------------ | ------------------------------------ |
+| [Exec Module](/cli/modules/exec)       | apic/exec    | To run system commands               |
+| [Env Module](/cli/modules/env)         | apic/env     | To set and get environment variables |
+| [Strings Module](/cli/modules/strings) | apic/strings | To check string casing               |
+
+:::caution
+
+Right now apic doen't support importing anything else, even relative JS file.
+
+We are still working on ways to package complex plugins.
+
+Soon will add support to apic to support complex plugins.
+:::

docs/docs/cli/modules/strings.md

@@ -0,0 +1,52 @@
+# Strings Module
+
+To check for string casing and some more operations not covered by the JS strings.
+
+## Functions
+
+### isCasing
+
+```js
+import { isCasing } from "apic/strings";
+
+const value = "hello_world";
+const check = isCasing(value, "snakecase");
+```
+
+To check whether given value is a valid provided casing.
+
+The casing can be snakecase, camelcase, pascalcase and kebabcase.
+
+### isPlural
+
+```js
+import { isPlural } from "apic/strings";
+
+const value = "properties";
+const check = isPlural(value);
+```
+
+### isSingular
+
+```js
+import { isSingular } from "apic/strings";
+
+const value = "property";
+const check = isSingular(value);
+```
+
+### pluralize
+
+```js
+import { pluralize } from "apic/strings";
+
+const value = pluralize("property");
+```
+
+### singular
+
+```js
+import { singular } from "apic/strings";
+
+const value = singular("properties");
+```

docs/docs/cli/overview.md

@@ -6,7 +6,7 @@ It mainly validates your API schema file, runs it against the rules you have spe
 
 ## CLI Architecture
 
-[image-to-be-added-cli-arch]
+![cli-architecture](/img/cli-arch.png)
 
 ### Config
 
@@ -40,6 +40,14 @@ plugins:
 
 </details>
 
+:::info
+
+Rules section points towards builtin apic rules
+
+Where as plugins sections points towards user defined rules
+
+:::
+
 ### Rules
 
 Rules are the validations executed over a schema file.

docs/docs/cli/rules/builtin/openapi/ status-code-check.md

@@ -0,0 +1,14 @@
+# Status Code Checks
+
+## Desc
+
+1. Rule Name: status_code_check
+2. Category: quality
+
+Checks whether there is any invalid status code. Also can be used only allow particular set of status code in an API.
+
+## Options
+
+| Name                 | Desc                                     | Required | Type     | Default |
+| -------------------- | ---------------------------------------- | -------- | -------- | ------- |
+| allowed_status_codes | status code that are only allowed in api | false    | String[] | [ ]     |

docs/docs/cli/rules/builtin/openapi/body-in-get.md

@@ -0,0 +1,12 @@
+# Body In Get Request
+
+## Desc
+
+1. Rule Name: body_in_get_req
+2. Category: security
+
+Check whether there is body in a GET request.
+
+## Options
+
+None