If we look at the springframework schema, they word wrap their documentation and use CDATA section
<xsd:attribute name="lazy-init" default="default" type="defaultable-boolean">
Indicates whether or not this bean is to be lazily initialized.
If false, it will be instantiated on startup by bean factories
that perform eager initialization of singletons. The default is
Note: This attribute will not be inherited by child bean definitions.
Hence, it needs to be specified per concrete bean definition.
As our documentation is single line, then it can be very long. I wonder if we should not word wrap as well, and format similar to spring so its easier to read directly from the schema file.