Document the Sensu Runtime Asset Archive format
[Engineering Wiki](https://github.com/sensu/engineering/wiki)
-## API
+## Sensu Agent
-### Checks
+### Assets
-#### Create a check
+#### Archive Format Specification
+
+A valid asset archive may contain the following directories:
+
+```
+<path_to_asset>/bin # automatically prepended to the PATH environment variable
+<path_to_asset>/include # automatically prepended to the CPATH environment variable
+<path_to_asset>/lib # automatically prepended to the LD_LIBRARY_PATH environment variable
+```
+
+Files within these three directories will be available through the corresponding
+environment variable. Any other directory will be ignored.
+
+## Sensu Backend
+
+### API
+
+#### Checks
+
+##### Create a check
```
curl -i -X POST -H 'Content-Type: application/json' -d '{"name": "check1", "interval": 60, "command": "echo 0", "subscriptions": "linux", "organization": "default"}' http://127.0.0.1:8080/checks
```
-### Events
+#### Events
-#### Update an event
+##### Update an event
Also used to create events.
@@ -24,18 +43,18 @@ Also used to create events.
curl -i -X PUT -H 'Content-Type: application/json' -d '{"check": {"name": "check1", "interval": 60, "command": "echo 0"}, "entity": {"id": "scotch.local"}, "timestamp": 1493114080}' http://127.0.0.1:8080/events
```
-### Users
+#### Users
-#### Create a user
+##### Create a user
```
curl -i -X PUT -H 'Content-Type: application/json' -d '{"username": "foo", "password": "P@ssw0rd!"}' http://127.0.0.1:8080/users
```
-## Backend
-
### Configuration
#### API Authentication
-Use the `--api-authentication` flag with **sensu-backend**.
+Use the `--api-authentication` flag with **sensu-backend** binary.
+
+## Sensu CLI
