[CAMEL-8381] XML XSD enriched documentation should maybe word wrap for easier read in raw format

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.15.0
• Fix Version/s: 2.16.0
• Component/s: camel-blueprint, camel-spring, tooling
• Estimated Complexity: Unknown
• Assignee: Claus Ibsen
• Reporter: Claus Ibsen
• Created: 20/Feb/15 09:47
• Updated: 08/Mar/15 10:13
• Resolved: 08/Mar/15 08:04

Description

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">
			<xsd:annotation>
				<xsd:documentation><![CDATA[
	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
	"false".

	Note: This attribute will not be inherited by child bean definitions.
	Hence, it needs to be specified per concrete bean definition.
				]]></xsd:documentation>
			</xsd:annotation>
		</xsd:attribute>

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.

Issue Links

• relates to: CAMEL-8334 EIP documentation maven plugin should aslo inject documentation to abstract/base types