diff --git a/README.md b/README.md
index d379b67..604ae21 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,7 @@ Simulation framework for germanium detector experiments
![GitHub pull requests](https://img.shields.io/github/issues-pr/legend-exp/remage?logo=github)
![License](https://img.shields.io/github/license/legend-exp/remage)
[![Read the Docs](https://img.shields.io/readthedocs/remage?logo=readthedocs)](https://remage.readthedocs.io)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11115662.svg)](https://doi.org/10.5281/zenodo.11115662)
diff --git a/docs/index.rst b/docs/index.rst
index 01f68e4..28e53c5 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -26,6 +26,7 @@ Optional dependencies
- |root|_ 6.06 or higher
- |bxdecay0|_ 1.0.10 or higher
+- |hdf5|_ C++ support for LH5 object persistency
.. note::
@@ -86,6 +87,9 @@ through the ``remage`` executable:
-o,--output-file FILE Output file for detector hits
+Macro files can use all available upstream Geant4 macro commands, as well as the
+:doc:`remage macro interface `.
+
Advanced applications can extend |remage| and link against ``libremage`` with the
usual CMake syntax:
@@ -105,8 +109,16 @@ Next steps
Geant4 command interface
Output structure & LH5 output