> [[doc::brief("Allocates memory on the heap")]]
> [[doc::param(bytes, "The number of bytes to allocate")]]
> [[doc::return("A pointer to the heap or nullptr in case of an exception")]]

That seems a lot more verbose than

> @brief Allocates memory on the heap
> @param bytes The number of bytes to allocate
> @return A pointer to the heap or nullptr in case of an exception

.. so, no thanks, I don't want to write the above. If the goal is to
just provide documentation for C++ constructs, there doesn't seem to
be any technical reason why it couldn't live in a comment rather than
an attribute anyway.