diff --git a/README.md b/README.md
index 2732554..69f0d70 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,52 @@
-# Abide
+
+ abide
+
+
+[](https://slack.com/app_redirect?channel=support-frontend-dx)
+[](https://wiki.atl.workiva.net/display/FEF/Frontend+Dev+Experience)
+[](https://github.com/Workiva/intl_tools/actions/workflows/ci.yaml)
+[](https://codecov.io/gh/Workiva/abide)
+
A command line tool to manage `analysis_options.yaml` and check if it abides by requirements.
This project is meant to be a tool for both local and CI use.
+## Installing
+
+### As a dependency
+Add it to your pubspec.yaml under dev_dependencies:
+```
+dev_dependencies:
+ abide: ^1.6.0
+```
+
+This will allow you to `pub run abide` in this project directory. If you want to be
+able to run abide on any project without updating project dependencies, use the
+global install instructions below. You can install it both ways and run either
+the project version or the global version
+ - `pub run abide` - Runs the local project version
+ - `pub global run abide` - Runs the globally installed version
+
+### As a global install
+1. To install or update to the latest version, run:
+```
+pub global activate abide
+```
+
+ 2. It is highly recommended to add `~/.pub-cache/bin` to your system PATH to be able to run abide directly.
+ - Without PATH set: `pub global run abide`
+ - With PATH set: `abide` (much better)
+
+
+
+To install a local version, clone it from github and activate it from the current directory.
+
+```
+git clone git@github.com:Workiva/abide.git
+cd abide
+pub global activate --source path .
+```
+
## What does it do?
### Running `abide` will check for these recommendations
@@ -55,42 +99,6 @@ abide help (shows this help)
without this option, abide will attempt to preserve the state of any commented out rules.
```
-## Installing
-
-### As a dependency
-Add it to your pubspec.yaml under dev_dependencies:
-```
-dev_dependencies:
- abide: ^1.6.0
-```
-
-This will allow you to `pub run abide` in this project directory. If you want to be
-able to run abide on any project without updating project dependencies, use the
-global install instructions below. You can install it both ways and run either
-the project version or the global version
- - `pub run abide` - Runs the local project version
- - `pub global run abide` - Runs the globally installed version
-
-### As a global install
-1. To install or update to the latest version, run:
-```
-pub global activate abide
-```
-
- 2. It is highly recommended to add `~/.pub-cache/bin` to your system PATH to be able to run abide directly.
- - Without PATH set: `pub global run abide`
- - With PATH set: `abide` (much better)
-
-
-
-To install a local version, clone it from github and activate it from the current directory.
-
-```
-git clone git@github.com:Workiva/abide.git
-cd abide
-pub global activate --source path .
-```
-
## Upgrading the lints in abide.yaml
For abide maintainers, there is an additional tool under `upgrade/` to automatically upgrade