diff --git a/include/boost/histogram/iterator.hpp b/include/boost/histogram/iterator.hpp
index da848b96..73696f8b 100644
--- a/include/boost/histogram/iterator.hpp
+++ b/include/boost/histogram/iterator.hpp
@@ -15,6 +15,7 @@
 namespace boost {
 namespace histogram {
 
+/// Fancy iterator over histogram bins with access multi-dimensional index.
 template <typename Histogram>
 class iterator_over
     : public iterator_facade<iterator_over<Histogram>, typename Histogram::element_type,
diff --git a/include/boost/histogram/weight.hpp b/include/boost/histogram/weight.hpp
index b084272e..50baf61e 100644
--- a/include/boost/histogram/weight.hpp
+++ b/include/boost/histogram/weight.hpp
@@ -21,11 +21,13 @@ struct sample_type {
 };
 } // namespace detail
 
+/// Helper function to mark argument as a weight
 template <typename T>
 detail::weight_type<T> weight(T&& t) {
   return {t};
 }
 
+/// Helper function to mark argument as a sample
 template <typename T>
 detail::sample_type<T> sample(T&& t) {
   return {t};