feat(docs): add maven docs and alpha notice

README.md

@@ -12,6 +12,8 @@ This tool integrates directly with the [FOSSA](https://fossa.io) web service to
 
 The CLI provides an alternative path to integrating your code repositories and builds in a way that doesn't require code access or FOSSA environment setup, or enrich dependency reports with dynamically confirmed dependency artifacts.
 
+**FOSSA CLI is currently in alpha and will have a changing API; join our contributor group to get development updates**
+
 ## Installation
 
 `fossa-cli` is compatible with Windows, Darwin (MacOS) and *nix-based operating systems.

docs/maven.md

@@ -0,0 +1,29 @@
+# Maven Support
+
+Maven support in `fossa-cli` depends on the following tools existing in your environment:
+
+- Java
+- Maven
+- `mvn:dependencyList` plugin (auto-installed if missing)
+
+## Configuration
+
+Add a `MavenArtifact` module with the **relative** path to the `pom.xml` in your root directory.
+
+```yaml
+analyze:
+  modules:
+    - name: yourmavenpackage
+      path: pom.xml
+      type: MavenArtifact
+```
+
+If you have an existing passing production build, you can run `fossa` in your existing environment and it should succeed.
+
+Otherwise, you can run `fossa --install` to execute with a default build command `mvn clean install -DskipTests -Drat.skip=true -f $PATH_TO_POM`.
+
+## Troubleshooting
+
+`fossa-cli` runs and parses the output of the `mvn:dependencyList` plugin to generate dependency IDs.  If FOSSA fails, chances are your build or the `mvn:dependencyList` plugin is failing.
+
+Run `mvn:dependencyList -f $PATH_TO_POM` and check the output to diagnose what went wrong.