• Introduction
• Why Mallard?
• About this book
• About Mallard
• Pre-requisites
• Comparing Mallard to other tools
• Projects that use Mallard
• Core Mallard
• Mallard in action
• Basic concepts
• Guide pages
• Topic pages
• Basic tutorial
• Integration
• Integration requirements
• Yelp
• Yelp tools
• Build system integration
• Context-sensitive help
• Extended Mallard
• Pages and sections
• Information element
• Linking pages
• Titles
• Page descriptions
• Block elements
• Inline elements
• Editorial comments
• Lists
• Tables
• style attribute
• XInclude
• Namespaces
• Appendix
• Further resources

Editorial comments

About

You can leave editorial comments for other writers and for later reference, including information about the note. Editorial comments can be printed to a terminal using yelp‑tools or viewed in Yelp using editor mode.

Example

<comment>
  <title>Mallards are dabbling ducks</title>
  <cite date="2009-05-07" href="mailto:drake@example.com">Drake</cite>
  <p>The information in this section is wrong. Mallards are dabbling
  ducks, not diving ducks.</p>
</comment>

Learn more

For more on comments, see the Mallard specification at http://projectmallard.org/1.0/mal_block_comment