Comment 3 for bug 510650

I think we need to establish indent parameters, too. Should we use a tab for indent, or a double space? I noticed that a lot of the gnome-user-docs pages don't have any formatting, particularly in the top sections of the document before it gets to the real material.

I also think that only the lowest level elements should be on the same line as the actual text, like you did above.
    <item><p>
      <app>Skype</app>
    </p></item>

In fact, that could be:
    <item>
      <p>
        <app>Skype</app>
      </p>
    </item>

This helps with viewing the document for syntax errors as well. Even the validation checker can be confusing when it spits out a problem, I spent a full five minutes trying to track down a silly problem today when it told me the document was invalid, and it was a small document at that.