Update Readme and Bug Report (#94)

* Cosmetic updates to README.md

* update documentation copy in README.md

* update  README.md

* Update README.md image link

* update bug report

Author: anaptfox

.github/ISSUE_TEMPLATE/bug_report.md

@@ -7,32 +7,28 @@ assignees: ''
 
 ---
 
-**Describe the bug**
-A clear and concise description of what the bug is.
+**Describe the bug**  
 
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
+From a high level, describe the problem you ran into.
 
-**Expected behavior**
-A clear and concise description of what you expected to happen.
+**Machine (please complete the following information):**  
 
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
  - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
+ - CLI Version [e.g. 22]
+
+**To Reproduce**  
+
+What can we do to reproduce your bug?
+
+Please provide:
+- Relevent CLI commands
+- Relevent environment details
+
+**Expected behavior**  
+What did you expect to happen? 
 
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
+**Screenshots**  
+If applicable, add screenshots to help explain your problem. (Be sure to scrub any sensitive information.)
 
-**Additional context**
+**Additional context**  
 Add any other context about the problem here.

README.md

@@ -1,46 +1,48 @@
-# Meroxa CLI
+<img src="https://meroxa-public-assets.s3.us-east-2.amazonaws.com/MeroxaTransparent%402x.png" alt="Meroxa" width="300">  
 
+We believe that anyone should be empowered to leverage real-time data. Using the Meroxa CLI, you can build data infrastructure in minutes not months.
+
+[Website](https://meroxa.io) |
+[Documentation](https://docs.meroxa.com/) |
+[Installation Guide](https://docs.meroxa.com/docs/installation-guide) |
+[Contribution Guide](CONTRIBUTING.md) |
+[Twitter](https://twitter.com/meroxadata)
 
 ## Documentation
 
-Our Meroxa CLI is documented publicly in https://docs.meroxa.com/docs, but on each build we also generate Markdown files for each command, exposing the available commands and help for each one. Check them out at [docs/commands/meroxa](docs/commands/meroxa.md).
+Meroxa is documented publicly in https://docs.meroxa.com/docs, but on each build we also generate Markdown files for each command, exposing the available commands and help for each one. Check it out at [docs/commands/meroxa](docs/commands/meroxa.md).
 
-## Our commands
+## Contributing
 
-All commands start with `meroxa` which is the name of the binary.
+For a complete guide to contributing to the Meroxa CLI, see the [Contribution Guide](CONTRIBUTING.md).
 
-### Build
+## Installation Guide
 
-Build CLI as `meroxa` binary:
+Please follow the installation instructions in the [Meroxa Documentation](http://docs.meroxa.com/).
 
-```
-make build
-```
+### Build and Install the Binaries from Source (Advanced Install)
 
-## Linting
+Currently, we provide pre-built Meroxa binaries for macOS (Darwin) Windows, and Linux architectures.
 
-If you want to make sure everything's correct before pushing to GitHub, you'll need to install [`golangci-lint`](https://golangci-lint.run/) and run:
+See [Releases](https://github.com/meroxa/cli/releases).
 
-```
-$ golangci-lint run
-```
+Prerequisite Tools:
 
-Example:
+* [Git](https://git-scm.com/)
+* [Go](https://golang.org/dl/)
+
+To build from source:
+
+1. The CLI depends on [meroxa-go](github.com/meroxa/meroxa-go) (which is currently a private repo). To update vendoring the dependency, you'll need to run the following:
 
 ```
-❯ golangci-lint run
-cmd/display.go:60:6: `appendCell` is unused (deadcode)
-func appendCell(cells []*simpletable.Cell, text string) []*simpletable.Cell {
-     ^
+make gomod
 ```
 
-## Vendor
-
-The CLI depends on [meroxa-go](github.com/meroxa/meroxa-go) which is currently
-a private repo. To update vendoring the dependency, you'll need to run the following:
+2. Build CLI as `meroxa` binary:
 
 ```
-make gomod
+make build
 ```
 
 ## Release
@@ -52,12 +54,27 @@ git tag is pushed to the repo.
 * Tag - `git tag -a vX.X.X -m "<message goes here>"`
 * Push - `git push origin vX.X.X`
 
-## Tests
+## Linting
+
+If you want to make sure everything's correct before pushing to GitHub, you'll need to install [`golangci-lint`](https://golangci-lint.run/) and run:
 
 ```
-make test
+$ golangci-lint run
 ```
 
-## Contributing
+Example:
 
-See [CONTRIBUTING.md](/CONTRIBUTING.md).
+```
+❯ golangci-lint run
+cmd/display.go:60:6: `appendCell` is unused (deadcode)
+func appendCell(cells []*simpletable.Cell, text string) []*simpletable.Cell {
+     ^
+```
+
+## Tests
+
+To run the test suite:
+
+```
+make test
+```