diff --git a/src/BaseIO.hpp b/src/BaseIO.hpp
index 83d1c9f2..3dd375db 100644
--- a/src/BaseIO.hpp
+++ b/src/BaseIO.hpp
@@ -15,6 +15,10 @@ using Status = AQNWB::Types::Status;
 using SizeArray = AQNWB::Types::SizeArray;
 using SizeType = AQNWB::Types::SizeType;
 
+/*!
+ * \namespace AQNWB
+ * \brief The main namespace for AqNWB
+ */
 namespace AQNWB
 {
 
diff --git a/src/hdf5/HDF5IO.hpp b/src/hdf5/HDF5IO.hpp
index 9ccb39b6..2a94aef2 100644
--- a/src/hdf5/HDF5IO.hpp
+++ b/src/hdf5/HDF5IO.hpp
@@ -17,6 +17,10 @@ class DataType;
 class Exception;
 }  // namespace H5
 
+/*!
+ * \namespace AQNWB::HDF5
+ * \brief Namespace for all components of the HDF5 I/O backend
+ */
 namespace AQNWB::HDF5
 {
 class HDF5RecordingData;  // declare here because gets used in HDF5IO class
diff --git a/src/nwb/NWBFile.hpp b/src/nwb/NWBFile.hpp
index f4e58bf4..04a0b357 100644
--- a/src/nwb/NWBFile.hpp
+++ b/src/nwb/NWBFile.hpp
@@ -8,6 +8,10 @@
 #include "Types.hpp"
 #include "nwb/base/TimeSeries.hpp"
 
+/*!
+ * \namespace AQNWB::NWB
+ * \brief Namespace for all classes related to the NWB data standard
+ */
 namespace AQNWB::NWB
 {