chore: update --help docs

Author: JackuB

help/commands-docs/_ENVIRONMENT.md

@@ -13,3 +13,5 @@ You can set these environment variables to change CLI run settings. These keys w
 
 - `SNYK_CFG_`<KEY>:
   Allows you to override any key that's also available as `snyk config` option.
+
+  E.g. `SNYK_CFG_ORG`=myorg will override default org option in `config` with "myorg".

help/commands-docs/_EXAMPLES.md

@@ -19,7 +19,6 @@ See `snyk container --help` for more details and examples:
 
     $ snyk container test ubuntu:18.04 --org=my-team
     $ snyk container test app:latest --file=Dockerfile --policy-path=path/to/.snyk
-    $ snyk test --yarn-workspaces --detection-depth=4 --strict-out-of-sync=false
 
 ### Infrastructure as Code (IAC) scanning
 

help/commands-docs/_SNYK_COMMAND_HEADER.md

@@ -6,7 +6,7 @@
 
 ## DESCRIPTION
 
-Snyk helps you find, fix and monitor known vulnerabilities in open-source dependencies.<br />
+Snyk helps you find, fix and monitor known vulnerabilities in open source dependencies.<br />
 For more information see https://snyk.io
 
 ### Not sure where to start?
@@ -21,13 +21,13 @@ To see command-specific flags and usage, see `help` command, e.g. `snyk containe
 Available top-level CLI commands:
 
 - `auth` \[<API_TOKEN>\]:
-  Authenticate Snyk CLI with a Snyk account
+  Authenticate Snyk CLI with a Snyk account.
 
 - `test`:
-  Test local project for vulnerabilities
+  Test local project for vulnerabilities.
 
 - `monitor`:
-  Snapshot and continuously monitor your project
+  Snapshot and continuously monitor your project.
 
 - `container`:
   Test container images for vulnerabilities. See `snyk container --help` for full instructions.
@@ -36,16 +36,16 @@ Available top-level CLI commands:
   Find security issues in your Infrastructure as Code files. See `snyk iac --help` for full instructions.
 
 - `config`:
-  Manage Snyk CLI configuration
+  Manage Snyk CLI configuration.
 
 - `protect`:
-  Applies the patches specified in your .snyk file to the local file system
+  Applies the patches specified in your .snyk file to the local file system.
 
 - `policy`:
   Display the .snyk policy for a package.
 
 - `ignore`:
-  Modifies the .snyk policy to ignore stated issues
+  Modifies the .snyk policy to ignore stated issues.
 
 - `wizard`:
   Configure your policy file to update, auto patch and ignore vulnerabilities. Snyk wizard updates your .snyk file.

help/commands-docs/_SNYK_COMMAND_OPTIONS.md

@@ -32,7 +32,7 @@ For advanced usage, we offer language and context specific flags, listed further
   Set or override the remote URL for the repository that you would like to monitor.
 
 - `--dev`:
-  Include devDependencies.
+  Include development-only dependencies. Applicable only for some package managers. E.g. _devDependencies_ in npm or _:development_ dependencies in Gemfile.
 
   Default: scan only production dependencies
 

help/commands-docs/container.md

@@ -26,7 +26,7 @@ Find vulnerabilities in your container images.
 
 - `--platform`=<PLATFORM>:
   For multi-architecture images, specify the platform to test.
-  [linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7 orlinux/arm/v6]
+  [linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7 or linux/arm/v6]
 
 - `--json`:
   Prints results in JSON format.