diff --git a/README.md b/README.md
index 506532de..d2162047 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
 [![ci](https://github.com/flux-framework/flux-accounting/workflows/ci/badge.svg)](https://github.com/flux-framework/flux-accounting/actions?query=workflow%3A.github%2Fworkflows%2Fmain.yml)
 [![codecov](https://codecov.io/gh/flux-framework/flux-accounting/branch/master/graph/badge.svg)](https://codecov.io/gh/flux-framework/flux-accounting)
+![docs](https://readthedocs.org/projects/flux-accounting/badge/?version=latest)
 
 _NOTE: The interfaces of flux-accounting are being actively developed and are
 not yet stable. The Github issue tracker is the primary way to communicate with
@@ -54,6 +55,12 @@ mounting /Users/moussa1/src/flux-framework/flux-accounting as /usr/src
 [moussa1@docker-desktop src]$
 ```
 
+### Documentation
+
+To see detailed documentation about installing, administering, and configuring
+flux-accounting, please see our official
+[documentation pages](https://flux-accounting.readthedocs.io/en/latest/index.html).
+
 #### Release
 
 SPDX-License-Identifier: LGPL-3.0