docs: add user facing documentation for real-time logs

runatlantis.io/.vuepress/config.js

@@ -35,9 +35,13 @@ module.exports = {
             {text: 'Home', link: '/'},
             {text: 'Guide', link: '/guide/'},
             {text: 'Docs', link: '/docs/'},
+            {text: 'Streaming Logs', link: '/logs/'},
             {text: 'Blog', link: 'https://medium.com/runatlantis'}
         ],
         sidebar: {
+            '/logs/': [
+                '',
+            ],
             '/guide/': [
                 '',
                 'test-drive',

runatlantis.io/guide/testing-locally.md

@@ -310,6 +310,10 @@ atlantis plan -- -target=resource -var 'foo=bar'
 If you'd like to `apply`, type a comment: `atlantis apply`. You can use the `-d` or `-w` flags to point
 Atlantis at a specific plan. Otherwise it tries to apply the plan for the root directory.
 
+## Real-time logs
+The [real-time terraform output](/logs/README.md) for your command can be found by clicking into the status check for a given project in a PR which
+links to the log-streaming UI. This is a terminal UI where you can view your commands executing in real-time. 
+
 ## Next Steps
 * If things are working as expected you can `Ctrl-C` the `atlantis server` command and the `ngrok` command.
 * Hopefully Atlantis is working with your repo and you're ready to move on to a [production-ready deployment](../docs/deployment.html).

runatlantis.io/logs/README.md

@@ -0,0 +1,25 @@
+# Real-time logs
+
+## Getting Started
+Atlantis supports streaming terraform logs in real time by default. Currently, only two commands are supported
+
+* terraform init
+* terraform plan
+* terraform apply
+
+::: warning
+As of now, custom workflow outputs and other terraform commands are not supported
+:::
+
+In order to view real-time terraform logs, a user can navigate through the *details* section of a given project's plan or apply status check.
+
+![Plan Command](./images/plan.png)
+
+This will link to the atlantis UI which provides real-time logging in addition to native terraform syntax highlighting.
+
+![Plan Output](./images/plan_output.png)
+
+::: warning
+As of now the logs are currently stored in memory and cleared when a given pull request is closed, so this link shouldn't be persisted anywhere.
+:::
+