summaryrefslogtreecommitdiff
path: root/sandbox/mallard/spec/principles.xml
blob: 3ccf744b87e705feb6a2a631a9e81d3c7d197593 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<guide xmlns="http://www.gnome.org/~shaunm/mallard"
       id="principles">
<info>
  <version number="0.1" date="2007-02-21" status="stub"/>
  <desc>The guiding principles behind the design of Mallard</desc>
</info>

<title>Design Principles</title>

<comment>
  <cite name="Shaun McCance" date="2007-02-27"/>
  <p>Add intro content</p>
  <p>Add principles: pluggability, implementation speed, l10n</p>
</comment>

<section id="reader">
  <info>
    <title type="link">Principles for the Reader</title>
  </info>

  <title>For the Reader</title>

  <p>Readers are the ultimate arbiters of the quality of a documentation
  system.  The best efforts of the writers and hackers are wasted if the
  documention doesn't help the reader to find the information she needs
  quickly.  The needs of the reader trump all other requirements.</p>
</section>

<section id="writer">
  <info>
    <title type="link">Principles for the Writer</title>
  </info>
  <title>For the Writer</title>
</section>

<section id="hacker">
  <info>
    <title type="link">Principles for the Hacker</title>
  </info>
  <title>For the Hacker</title>
</section>

</guide>