diff --git a/README.md b/README.md
index 2e67f6b0a5f3ab647e1a3d149c8e44a4eee866b3..df8c56e4ea86e4c0f8904b20409c4d32c3f0a4c4 100644
--- a/README.md
+++ b/README.md
@@ -44,7 +44,9 @@ Once you have promtail, Loki, and Grafana running, continue with [our usage docs
 
 - [API documentation](./docs/api.md) for alternative ways of getting logs into Loki.
 - [Operations](./docs/operations.md) for important aspects of running Loki.
+- [Promtail](./docs/promtail-setup.md) on how to configure the agent that tails your logs.
 - [Troubleshooting](./docs/troubleshooting.md) for help around frequent error messages.
+- [Usage](./docs/usage.md) for how to set up a Loki datasource in Grafana and query your logs.
 
 ## Getting Help
 
diff --git a/production/README.md b/production/README.md
index a4ff76d6685f36acb336e805639ba0c06782be4c..3496fab5b8bd31ff4f90022ff9ae768ef1555db1 100644
--- a/production/README.md
+++ b/production/README.md
@@ -8,6 +8,8 @@ Currently there are five ways to try out Loki, in order from easier to hardest:
 - [Building from source](#build-and-run-from-source)
 - [Get inspired by our production setup](#get-inspired-by-our-production-setup)
 
+For the various ways to run `promtail`, the tailing agent, see our [Promtail documentation](../docs/promtail-setup.md).
+
 ## Get a Free Hosted Demo of Grafana Cloud: Logs
 
 Grafana is running a free, hosted demo cluster of Loki; instructions for getting access can be found at [grafana.com/loki](https://grafana.com/loki).