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.

-- 
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/510650

Title:
  Standardize source formatting of ubuntu-docs source xml

-- 
ubuntu-bugs mailing list
ubuntu-bugs@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to