Starting with this version new functionality is mainly implemented in
[docutils/kirr.git] / sandbox / xml2rst / tests / real / readable / WikiRequirements.xml
blobe4572fa12ed1677218d64782524acc9e3a9fbfa5
1 <?xml version="1.0" encoding="utf-8"?>
2 <!-- Generated by Docutils 0.9 -->
3 <document source="original/WikiRequirements.rst">
4     <paragraph>
5         #FORMAT rst
6     </paragraph>
7     <section ids="requirements-for-an-oekonux-wiki" names="requirements\ for\ an\ oekonux\ wiki">
8         <title refid="id1">
9             Requirements for an Oekonux Wiki
10         </title>
11         <topic classes="contents" ids="contents" names="contents">
12             <title>
13                 Contents
14             </title>
15             <bullet_list>
16                 <list_item>
17                     <paragraph>
18                         <reference ids="id1" refid="requirements-for-an-oekonux-wiki">
19                             Requirements for an Oekonux Wiki
20                         </reference>
21                     </paragraph>
22                 </list_item>
23                 <list_item>
24                     <paragraph>
25                         <reference ids="id2" refid="introduction">
26                             Introduction
27                         </reference>
28                     </paragraph>
29                 </list_item>
30                 <list_item>
31                     <paragraph>
32                         <reference ids="id3" refid="requirements">
33                             Requirements
34                         </reference>
35                     </paragraph>
36                     <bullet_list>
37                         <list_item>
38                             <paragraph>
39                                 <reference ids="id4" refid="non-functional-requirements">
40                                     Non-functional requirements
41                                 </reference>
42                             </paragraph>
43                         </list_item>
44                         <list_item>
45                             <paragraph>
46                                 <reference ids="id5" refid="functional-requirements">
47                                     Functional requirements
48                                 </reference>
49                             </paragraph>
50                         </list_item>
51                         <list_item>
52                             <paragraph>
53                                 <reference ids="id6" refid="requirements-for-policy-choices">
54                                     Requirements for policy choices
55                                 </reference>
56                             </paragraph>
57                         </list_item>
58                     </bullet_list>
59                 </list_item>
60             </bullet_list>
61         </topic>
62         <comment xml:space="preserve">
63             ############################################################################
64         </comment>
65         <comment xml:space="preserve">
66             ############################################################################
67         </comment>
68     </section>
69     <section ids="introduction" names="introduction">
70         <title refid="id2">
71             Introduction
72         </title>
73         <paragraph>
74             In 
75             <reference name="Project Oekonux" refuri="http://www.oekonux.de/">
76                 Project Oekonux
77             </reference>
78              there has been a long discussion about setting
79 up a Wiki for the project. Also several attempts to establish a Wiki
80 have been made. Most of these discussions took place on 
81             <reference name="the projekt mailing list" refuri="http://www.oekonux.de/projekt/liste/">
82                 the projekt mailing list
83             </reference>
84             
85 which is the organizing body of the project.
86         </paragraph>
87         <paragraph>
88             One of the most important questions was which Wiki software to use.
89 Finally a decision has been made based upon the requirements being
90 raised.
91         </paragraph>
92         <paragraph>
93             The following lists all the requirements which have been found and
94 lists the alternative solutions for them. One reason for this list is
95 to document the design decisions / choices taken and their basis in
96 the requirements. This way it is easier to
97         </paragraph>
98         <bullet_list bullet="*">
99             <list_item>
100                 <paragraph>
101                     understand the decisions
102                 </paragraph>
103             </list_item>
104             <list_item>
105                 <paragraph>
106                     change decisions while not forgetting about reasons for the original
107 decision
108                 </paragraph>
109             </list_item>
110         </bullet_list>
111         <comment xml:space="preserve">
112             ############################################################################
113         </comment>
114         <comment xml:space="preserve">
115             ############################################################################
116         </comment>
117     </section>
118     <section ids="requirements" names="requirements">
119         <title refid="id3">
120             Requirements
121         </title>
122         <section ids="non-functional-requirements" names="non-functional\ requirements">
123             <title refid="id4">
124                 Non-functional requirements
125             </title>
126             <enumerated_list enumtype="arabic" prefix="" suffix=".">
127                 <list_item>
128                     <paragraph>
129                         The software must have an active developer community and must be
130 Free
131                     </paragraph>
132                     <field_list>
133                         <field>
134                             <field_name>
135                                 Rationale
136                             </field_name>
137                             <field_body>
138                                 <paragraph>
139                                     Only an active developer community of a Free Software
140 project guarantees for a constant development.
141                                 </paragraph>
142                             </field_body>
143                         </field>
144                     </field_list>
145                     <paragraph>
146                         Discussion came down to two candidates which met this requirement:
148                         <reference name="MediaWiki" refuri="http://wikipedia.sourceforge.net/">
149                             MediaWiki
150                         </reference>
151                          and 
152                         <reference name="MoinMoin" refuri="http://moinmoin.wikiwikiweb.de/">
153                             MoinMoin
154                         </reference>
155                         . The following requirements list
156 alternative solutions only for these two Wiki implementations.
157                     </paragraph>
158                 </list_item>
159                 <list_item>
160                     <paragraph>
161                         The software must be easy to use for people used to Wikipedia
162                     </paragraph>
163                     <field_list>
164                         <field>
165                             <field_name>
166                                 Rationale
167                             </field_name>
168                             <field_body>
169                                 <paragraph>
170                                     Because of the overwhelming success of Wikipedia many
171 people are used to the way how Wikipedia is operated.
172                                 </paragraph>
173                             </field_body>
174                         </field>
175                         <field>
176                             <field_name>
177                                 MediaWiki
178                             </field_name>
179                             <field_body>
180                                 <paragraph>
181                                     Given by definition.
182                                 </paragraph>
183                             </field_body>
184                         </field>
185                         <field>
186                             <field_name>
187                                 MoinMoin
188                             </field_name>
189                             <field_body>
190                                 <paragraph>
191                                     The typical use cases need to be identified and a
192 special help page must be created for these users.
193                                 </paragraph>
194                             </field_body>
195                         </field>
196                     </field_list>
197                 </list_item>
198             </enumerated_list>
199             <comment xml:space="preserve">
200                 ############################################################################
201             </comment>
202         </section>
203         <section ids="functional-requirements" names="functional\ requirements">
204             <title refid="id5">
205                 Functional requirements
206             </title>
207             <enumerated_list enumtype="arabic" prefix="" suffix=".">
208                 <list_item>
209                     <paragraph>
210                         Email notification must be possible sending diffs and other changes
211                     </paragraph>
212                     <field_list>
213                         <field>
214                             <field_name>
215                                 Rationale
216                             </field_name>
217                             <field_body>
218                                 <paragraph>
219                                     Email notification is a basic requirement for any
220 offline processing.
221                                 </paragraph>
222                             </field_body>
223                         </field>
224                         <field>
225                             <field_name>
226                                 MediaWiki
227                             </field_name>
228                             <field_body>
229                                 <paragraph>
230                                     Rumor has it that there is a plug-in for email
231 notification but nobody saw it yet (2005-03-26).
232                                 </paragraph>
233                             </field_body>
234                         </field>
235                         <field>
236                             <field_name>
237                                 MoinMoin
238                             </field_name>
239                             <field_body>
240                                 <paragraph>
241                                     Supports email notification as diffs for arbitrary pages
242 and page groups (regular expression). Only notifies on moves and
243 deletion of pages.
244                                 </paragraph>
245                             </field_body>
246                         </field>
247                     </field_list>
248                 </list_item>
249                 <list_item>
250                     <paragraph>
251                         It must be possible to limit changeability of a page (for instance
252 for user's pages)
253                     </paragraph>
254                     <field_list>
255                         <field>
256                             <field_name>
257                                 Rationale
258                             </field_name>
259                             <field_body>
260                                 <paragraph>
261                                     Some pages are private pages or should not be changes
262 for other reasons.
263                                 </paragraph>
264                             </field_body>
265                         </field>
266                         <field>
267                             <field_name>
268                                 MediaWiki
269                             </field_name>
270                             <field_body>
271                                 <paragraph>
272                                     Don't know whether this can be enforced technically.
273                                 </paragraph>
274                             </field_body>
275                         </field>
276                         <field>
277                             <field_name>
278                                 MoinMoin
279                             </field_name>
280                             <field_body>
281                                 <paragraph>
282                                     Implements access control lists (ACL) allowing for
283 arbitrary rights.
284                                 </paragraph>
285                             </field_body>
286                         </field>
287                     </field_list>
288                 </list_item>
289                 <list_item>
290                     <paragraph>
291                         Categories must be possible
292                     </paragraph>
293                     <field_list>
294                         <field>
295                             <field_name>
296                                 Rationale
297                             </field_name>
298                             <field_body>
299                                 <paragraph>
300                                     With categories can form arbitrary non-hierarchical
301 structures
302                                 </paragraph>
303                             </field_body>
304                         </field>
305                         <field>
306                             <field_name>
307                                 MediaWiki
308                             </field_name>
309                             <field_body>
310                                 <paragraph>
311                                     Available.
312                                 </paragraph>
313                             </field_body>
314                         </field>
315                         <field>
316                             <field_name>
317                                 MoinMoin
318                             </field_name>
319                             <field_body>
320                                 <paragraph>
321                                     Available.
322                                 </paragraph>
323                             </field_body>
324                         </field>
325                     </field_list>
326                 </list_item>
327                 <list_item>
328                     <paragraph>
329                         Navigation panels must be available
330                     </paragraph>
331                     <field_list>
332                         <field>
333                             <field_name>
334                                 Rationale
335                             </field_name>
336                             <field_body>
337                                 <paragraph>
338                                     Useful to create overviews.
339                                 </paragraph>
340                             </field_body>
341                         </field>
342                         <field>
343                             <field_name>
344                                 MediaWiki
345                             </field_name>
346                             <field_body>
347                                 <paragraph>
348                                     Available.
349                                 </paragraph>
350                             </field_body>
351                         </field>
352                         <field>
353                             <field_name>
354                                 MoinMoin
355                             </field_name>
356                             <field_body>
357                                 <paragraph>
358                                     Available as 
359                                     <literal>
360                                         Navigation
361                                     </literal>
362                                      macro for hierarchical
363 structures and as 
364                                     <literal>
365                                         PageList
366                                     </literal>
367                                      macro for structures based logical
368 expressions on regular expressions over page names.
369                                 </paragraph>
370                             </field_body>
371                         </field>
372                     </field_list>
373                 </list_item>
374                 <list_item>
375                     <paragraph>
376                         A version history must be available
377                     </paragraph>
378                     <field_list>
379                         <field>
380                             <field_name>
381                                 Rationale
382                             </field_name>
383                             <field_body>
384                                 <paragraph>
385                                     Needed to get an overview of the change history of a
386 page.
387                                 </paragraph>
388                             </field_body>
389                         </field>
390                         <field>
391                             <field_name>
392                                 MediaWiki
393                             </field_name>
394                             <field_body>
395                                 <paragraph>
396                                     Available.
397                                 </paragraph>
398                             </field_body>
399                         </field>
400                         <field>
401                             <field_name>
402                                 MoinMoin
403                             </field_name>
404                             <field_body>
405                                 <paragraph>
406                                     Available.
407                                 </paragraph>
408                             </field_body>
409                         </field>
410                     </field_list>
411                 </list_item>
412                 <list_item>
413                     <paragraph>
414                         List of changes for a given user must be available
415                     </paragraph>
416                     <field_list>
417                         <field>
418                             <field_name>
419                                 Rationale
420                             </field_name>
421                             <field_body>
422                                 <paragraph>
423                                     Nice to have.
424                                 </paragraph>
425                             </field_body>
426                         </field>
427                         <field>
428                             <field_name>
429                                 MediaWiki
430                             </field_name>
431                             <field_body>
432                                 <paragraph>
433                                     Available.
434                                 </paragraph>
435                             </field_body>
436                         </field>
437                         <field>
438                             <field_name>
439                                 MoinMoin
440                             </field_name>
441                             <field_body>
442                                 <paragraph>
443                                     Not available.
444                                 </paragraph>
445                             </field_body>
446                         </field>
447                     </field_list>
448                 </list_item>
449                 <list_item>
450                     <paragraph>
451                         A watch list must be possible reporting about the latest changes
452 for a given set of pages
453                     </paragraph>
454                     <field_list>
455                         <field>
456                             <field_name>
457                                 Rationale
458                             </field_name>
459                             <field_body>
460                                 <paragraph>
461                                     Nice to have.
462                                 </paragraph>
463                             </field_body>
464                         </field>
465                         <field>
466                             <field_name>
467                                 MediaWiki
468                             </field_name>
469                             <field_body>
470                                 <paragraph>
471                                     Available.
472                                 </paragraph>
473                             </field_body>
474                         </field>
475                         <field>
476                             <field_name>
477                                 MoinMoin
478                             </field_name>
479                             <field_body>
480                                 <paragraph>
481                                     Can be simulated by email notification.
482                                 </paragraph>
483                             </field_body>
484                         </field>
485                     </field_list>
486                 </list_item>
487                 <list_item>
488                     <paragraph>
489                         Automatic links by using CamelCase (aka WikiWords) must not be the
490 default
491                     </paragraph>
492                     <field_list>
493                         <field>
494                             <field_name>
495                                 Rationale
496                             </field_name>
497                             <field_body>
498                                 <paragraph>
499                                     CamelCase makes sense only in certain language. In
500 particular German is a language where automatic CamelCase links
501 are not too useful.
502                                 </paragraph>
503                             </field_body>
504                         </field>
505                         <field>
506                             <field_name>
507                                 MediaWiki
508                             </field_name>
509                             <field_body>
510                                 <paragraph>
511                                     CamelCase words never create automatic links.
512                                 </paragraph>
513                             </field_body>
514                         </field>
515                         <field>
516                             <field_name>
517                                 MoinMoin
518                             </field_name>
519                             <field_body>
520                                 <paragraph>
521                                     The 
522                                     <reference name="NoCamelCase" refuri="http://moinmoin.wikiwikiweb.de/ParserMarket/NoCamelCase">
523                                         NoCamelCase
524                                     </reference>
525                                      plug-in makes this the default.
526                                 </paragraph>
527                             </field_body>
528                         </field>
529                     </field_list>
530                 </list_item>
531                 <list_item>
532                     <paragraph>
533                         Support for other than the standard Wiki syntaxes like
535                         <reference name="reStructuredText" refuri="http://docutils.sourceforge.net/rst.html">
536                             reStructuredText
537                         </reference>
538                          must be available
539                     </paragraph>
540                     <field_list>
541                         <field>
542                             <field_name>
543                                 Rationale
544                             </field_name>
545                             <field_body>
546                                 <paragraph>
547                                     All Wiki languages suck so support for more sane
548 syntaxes is a very useful thing. In particular support for
550                                     <reference name="reStructuredText" refuri="http://docutils.sourceforge.net/rst.html">
551                                         reStructuredText
552                                     </reference>
553                                      being a powerful language and a good candidate
554 for a standard ASCII based markup language.
555                                 </paragraph>
556                             </field_body>
557                         </field>
558                         <field>
559                             <field_name>
560                                 MediaWiki
561                             </field_name>
562                             <field_body>
563                                 <paragraph>
564                                     There is no support for any other syntax than the
565 MediaWiki syntax.
566                                 </paragraph>
567                             </field_body>
568                         </field>
569                         <field>
570                             <field_name>
571                                 MoinMoin
572                             </field_name>
573                             <field_body>
574                                 <paragraph>
575                                     Offers several syntaxes by the concept of parsers. Among
576 the available syntaxes are 
577                                     <reference name="reStructuredText" refuri="http://docutils.sourceforge.net/rst.html">
578                                         reStructuredText
579                                     </reference>
580                                      and 
581                                     <reference name="LaTeX" refuri="http://www.latex-project.org/">
582                                         LaTeX
583                                     </reference>
584                                     .
585                                 </paragraph>
586                             </field_body>
587                         </field>
588                     </field_list>
589                 </list_item>
590                 <list_item>
591                     <paragraph>
592                         Arbitrary attachments must be possible
593                     </paragraph>
594                 </list_item>
595             </enumerated_list>
596             <block_quote>
597                 <field_list>
598                     <field>
599                         <field_name>
600                             Rationale
601                         </field_name>
602                         <field_body>
603                             <paragraph>
604                                 Nice to have to attach arbitrary data to a page. In
605 particular it makes possible to include material not marked up in
606 the Wiki syntax.
607                             </paragraph>
608                         </field_body>
609                     </field>
610                     <field>
611                         <field_name>
612                             MediaWiki
613                         </field_name>
614                         <field_body>
615                             <paragraph>
616                                 Unknown but probably available.
617                             </paragraph>
618                         </field_body>
619                     </field>
620                     <field>
621                         <field_name>
622                             MoinMoin
623                         </field_name>
624                         <field_body>
625                             <paragraph>
626                                 Available.
627                             </paragraph>
628                         </field_body>
629                     </field>
630                 </field_list>
631             </block_quote>
632             <enumerated_list enumtype="arabic" prefix="" start="11" suffix=".">
633                 <list_item>
634                     <paragraph>
635                         Shortcuts for links must be available
636                     </paragraph>
637                 </list_item>
638             </enumerated_list>
639             <block_quote>
640                 <field_list>
641                     <field>
642                         <field_name>
643                             Rationale
644                         </field_name>
645                         <field_body>
646                             <paragraph>
647                                 In particular it is useful to be able to reference
648 entries in the Oekonux mailing list archive as easy as possible.
649                             </paragraph>
650                         </field_body>
651                     </field>
652                     <field>
653                         <field_name>
654                             MediaWiki
655                         </field_name>
656                         <field_body>
657                             <paragraph>
658                                 Implements this by templates.
659                             </paragraph>
660                         </field_body>
661                     </field>
662                     <field>
663                         <field_name>
664                             MoinMoin
665                         </field_name>
666                         <field_body>
667                             <paragraph>
668                                 Implements by InterWiki links.
669                             </paragraph>
670                         </field_body>
671                     </field>
672                 </field_list>
673             </block_quote>
674             <enumerated_list enumtype="arabic" prefix="" start="12" suffix=".">
675                 <list_item>
676                     <paragraph>
677                         Page templates must be available
678                     </paragraph>
679                 </list_item>
680             </enumerated_list>
681             <block_quote>
682                 <field_list>
683                     <field>
684                         <field_name>
685                             Rationale
686                         </field_name>
687                         <field_body>
688                             <paragraph>
689                                 Page templates are a good way to support policy
690 decisions by offering standard templates for all page types.
691                             </paragraph>
692                         </field_body>
693                     </field>
694                     <field>
695                         <field_name>
696                             MediaWiki
697                         </field_name>
698                         <field_body>
699                             <paragraph>
700                                 Not available.
701                             </paragraph>
702                         </field_body>
703                     </field>
704                     <field>
705                         <field_name>
706                             MoinMoin
707                         </field_name>
708                         <field_body>
709                             <paragraph>
710                                 Available.
711                             </paragraph>
712                         </field_body>
713                     </field>
714                 </field_list>
715             </block_quote>
716             <enumerated_list enumtype="arabic" prefix="" start="13" suffix=".">
717                 <list_item>
718                     <paragraph>
719                         It must be possible to revert page changes
720                     </paragraph>
721                 </list_item>
722             </enumerated_list>
723             <block_quote>
724                 <field_list>
725                     <field>
726                         <field_name>
727                             Rationale
728                         </field_name>
729                         <field_body>
730                             <paragraph>
731                                 Useful to undo unwanted changes.
732                             </paragraph>
733                         </field_body>
734                     </field>
735                     <field>
736                         <field_name>
737                             MediaWiki
738                         </field_name>
739                         <field_body>
740                             <paragraph>
741                                 Available.
742                             </paragraph>
743                         </field_body>
744                     </field>
745                     <field>
746                         <field_name>
747                             MoinMoin
748                         </field_name>
749                         <field_body>
750                             <paragraph>
751                                 Available.
752                             </paragraph>
753                         </field_body>
754                     </field>
755                 </field_list>
756             </block_quote>
757             <enumerated_list enumtype="arabic" prefix="" start="14" suffix=".">
758                 <list_item>
759                     <paragraph>
760                         It must be possible to know who did a change in a page
761                     </paragraph>
762                 </list_item>
763             </enumerated_list>
764             <block_quote>
765                 <field_list>
766                     <field>
767                         <field_name>
768                             Rationale
769                         </field_name>
770                         <field_body>
771                             <paragraph>
772                                 Nice to have.
773                             </paragraph>
774                         </field_body>
775                     </field>
776                     <field>
777                         <field_name>
778                             MediaWiki
779                         </field_name>
780                         <field_body>
781                             <paragraph>
782                                 Available.
783                             </paragraph>
784                         </field_body>
785                     </field>
786                     <field>
787                         <field_name>
788                             MoinMoin
789                         </field_name>
790                         <field_body>
791                             <paragraph>
792                                 Available.
793                             </paragraph>
794                         </field_body>
795                     </field>
796                 </field_list>
797             </block_quote>
798             <enumerated_list enumtype="arabic" prefix="" start="15" suffix=".">
799                 <list_item>
800                     <paragraph>
801                         Offline usage must be possible as far as possible
802                     </paragraph>
803                 </list_item>
804             </enumerated_list>
805             <block_quote>
806                 <field_list>
807                     <field>
808                         <field_name>
809                             Rationale
810                         </field_name>
811                         <field_body>
812                             <paragraph>
813                                 Not everyone is always online so offline facilities are
814 generally useful. Offline usage includes
815                             </paragraph>
816                             <bullet_list bullet="*">
817                                 <list_item>
818                                     <paragraph>
819                                         a push feature for change notification
820                                     </paragraph>
821                                 </list_item>
822                                 <list_item>
823                                     <paragraph>
824                                         browsing
825                                     </paragraph>
826                                 </list_item>
827                                 <list_item>
828                                     <paragraph>
829                                         editing
830                                     </paragraph>
831                                 </list_item>
832                             </bullet_list>
833                         </field_body>
834                     </field>
835                     <field>
836                         <field_name>
837                             MediaWiki
838                         </field_name>
839                         <field_body>
840                             <paragraph>
841                                 Not available. At most email notification is available.
842                             </paragraph>
843                         </field_body>
844                     </field>
845                     <field>
846                         <field_name>
847                             MoinMoin
848                         </field_name>
849                         <field_body>
850                             <paragraph>
851                                 Email notification allows for monitoring changes and in
852 principle the diffs can be used to update a local copy. A local
853 installation of 
854                                 <reference name="MoinMoin" refuri="http://moinmoin.wikiwikiweb.de/">
855                                     MoinMoin
856                                 </reference>
857                                  only needs Python and 
858                                 <reference name="MoinMoin" refuri="http://moinmoin.wikiwikiweb.de/">
859                                     MoinMoin
860                                 </reference>
861                                  so it
862 is easy to accomplish. Because 
863                                 <reference name="MoinMoin" refuri="http://moinmoin.wikiwikiweb.de/">
864                                     MoinMoin
865                                 </reference>
866                                  uses a file based
867 storage scheme it is at least easy to update a local copy in
868 short online phases for offline use so at least offline browsing
869 is available.
870                             </paragraph>
871                         </field_body>
872                     </field>
873                 </field_list>
874             </block_quote>
875             <enumerated_list enumtype="arabic" prefix="" start="16" suffix=".">
876                 <list_item>
877                     <paragraph>
878                         Pages must be locked during they are edited
879                     </paragraph>
880                 </list_item>
881             </enumerated_list>
882             <block_quote>
883                 <field_list>
884                     <field>
885                         <field_name>
886                             Rationale
887                         </field_name>
888                         <field_body>
889                             <paragraph>
890                                 Page locking prevents parallel editing of a page which
891 is useful in a highly frequented Wiki.
892                             </paragraph>
893                         </field_body>
894                     </field>
895                     <field>
896                         <field_name>
897                             MediaWiki
898                         </field_name>
899                         <field_body>
900                             <paragraph>
901                                 Not available.
902                             </paragraph>
903                         </field_body>
904                     </field>
905                     <field>
906                         <field_name>
907                             MoinMoin
908                         </field_name>
909                         <field_body>
910                             <paragraph>
911                                 Editing a page locks it for 10 minutes and the lock can
912 be renewed.
913                             </paragraph>
914                         </field_body>
915                     </field>
916                 </field_list>
917             </block_quote>
918             <enumerated_list enumtype="arabic" prefix="" start="17" suffix=".">
919                 <list_item>
920                     <paragraph>
921                         It must be possible to edit sections of a page
922                     </paragraph>
923                 </list_item>
924             </enumerated_list>
925             <block_quote>
926                 <field_list>
927                     <field>
928                         <field_name>
929                             Rationale
930                         </field_name>
931                         <field_body>
932                             <paragraph>
933                                 Makes parallel editing of a page less dangerous which
934 is useful in a highly frequented Wiki.
935                             </paragraph>
936                         </field_body>
937                     </field>
938                     <field>
939                         <field_name>
940                             MediaWiki
941                         </field_name>
942                         <field_body>
943                             <paragraph>
944                                 Available.
945                             </paragraph>
946                         </field_body>
947                     </field>
948                     <field>
949                         <field_name>
950                             MoinMoin
951                         </field_name>
952                         <field_body>
953                             <paragraph>
954                                 Not available.
955                             </paragraph>
956                         </field_body>
957                     </field>
958                 </field_list>
959             </block_quote>
960             <comment xml:space="preserve">
961                 ############################################################################
962             </comment>
963         </section>
964         <section ids="requirements-for-policy-choices" names="requirements\ for\ policy\ choices">
965             <title refid="id6">
966                 Requirements for policy choices
967             </title>
968             <enumerated_list enumtype="arabic" prefix="" suffix=".">
969                 <list_item>
970                     <paragraph>
971                         Pages standing in a certain close relation to a certain other page
972 must be possible in a sane way
973                     </paragraph>
974                     <field_list>
975                         <field>
976                             <field_name>
977                                 Rationale
978                             </field_name>
979                             <field_body>
980                                 <paragraph>
981                                     There are several ways in which a page can have closely
982 related pages (e.g. discussion pages). It makes sense to have a
983 uniform way to express this relation.
984                                 </paragraph>
985                             </field_body>
986                         </field>
987                         <field>
988                             <field_name>
989                                 MediaWiki
990                             </field_name>
991                             <field_body>
992                                 <paragraph>
993                                     Implements discussion pages as one a special type of
994 closely related pages by suffixing 
995                                     <literal>
996                                         Discussion
997                                     </literal>
998                                      to the
999 namespace of a page. For other closely related pages there is no
1000 fixed implementation.
1001                                 </paragraph>
1002                             </field_body>
1003                         </field>
1004                         <field>
1005                             <field_name>
1006                                 MoinMoin
1007                             </field_name>
1008                             <field_body>
1009                                 <paragraph>
1010                                     By making sub-pages possible all types of closely
1011 related pages can be implemented by some fixed names being part
1012 of a policy and supported by page templates.
1013                                 </paragraph>
1014                             </field_body>
1015                         </field>
1016                     </field_list>
1017                 </list_item>
1018                 <list_item>
1019                     <paragraph>
1020                         Structuring of content must be possible by a page hierarchy
1021                     </paragraph>
1022                     <field_list>
1023                         <field>
1024                             <field_name>
1025                                 Rationale
1026                             </field_name>
1027                             <field_body>
1028                                 <paragraph>
1029                                     The maintenance policy may decide to have a page
1030 hierarchy as a structuring principle.
1031                                 </paragraph>
1032                             </field_body>
1033                         </field>
1034                         <field>
1035                             <field_name>
1036                                 MediaWiki
1037                             </field_name>
1038                             <field_body>
1039                                 <paragraph>
1040                                     Implements a top level structure by namespaces and
1041 allows for structuring otherwise.
1042                                 </paragraph>
1043                             </field_body>
1044                         </field>
1045                         <field>
1046                             <field_name>
1047                                 MoinMoin
1048                             </field_name>
1049                             <field_body>
1050                                 <paragraph>
1051                                     With sub-pages arbitrary hierarchies can be build on any
1052 level.
1053                                 </paragraph>
1054                             </field_body>
1055                         </field>
1056                     </field_list>
1057                 </list_item>
1058                 <list_item>
1059                     <paragraph>
1060                         Sub-Wikis must be possible
1061                     </paragraph>
1062                     <field_list>
1063                         <field>
1064                             <field_name>
1065                                 Rationale
1066                             </field_name>
1067                             <field_body>
1068                                 <paragraph>
1069                                     The maintenance policy may decide this makes sense.
1070                                 </paragraph>
1071                             </field_body>
1072                         </field>
1073                         <field>
1074                             <field_name>
1075                                 MediaWiki
1076                             </field_name>
1077                             <field_body>
1078                                 <paragraph>
1079                                     Not available.
1080                                 </paragraph>
1081                             </field_body>
1082                         </field>
1083                         <field>
1084                             <field_name>
1085                                 MoinMoin
1086                             </field_name>
1087                             <field_body>
1088                                 <paragraph>
1089                                     Could be done in a page hierarchy on any level.
1090                                 </paragraph>
1091                             </field_body>
1092                         </field>
1093                     </field_list>
1094                 </list_item>
1095                 <list_item>
1096                     <paragraph>
1097                         Underscores and white-space in page names must be possible but
1098 insignificant
1099                     </paragraph>
1100                     <field_list>
1101                         <field>
1102                             <field_name>
1103                                 Rationale
1104                             </field_name>
1105                             <field_body>
1106                                 <paragraph>
1107                                     If the maintenance policy decides that underscores and
1108 white-space may be used in arbitrary ways the software must be
1109 able to reflect this.
1110                                 </paragraph>
1111                             </field_body>
1112                         </field>
1113                         <field>
1114                             <field_name>
1115                                 MediaWiki
1116                             </field_name>
1117                             <field_body>
1118                                 <paragraph>
1119                                     Unknown.
1120                                 </paragraph>
1121                             </field_body>
1122                         </field>
1123                         <field>
1124                             <field_name>
1125                                 MoinMoin
1126                             </field_name>
1127                             <field_body>
1128                                 <paragraph>
1129                                     Underscores and white-space is significant.
1130                                 </paragraph>
1131                             </field_body>
1132                         </field>
1133                     </field_list>
1134                 </list_item>
1135             </enumerated_list>
1136             <comment xml:space="preserve">
1137                 ############################################################################
1138             </comment>
1139             <comment xml:space="preserve">
1140                 ############################################################################
1141             </comment>
1142             <substitution_definition names="projekt">
1143                 <reference name="the projekt mailing list" refuri="http://www.oekonux.de/projekt/liste/">
1144                     the projekt mailing list
1145                 </reference>
1146             </substitution_definition>
1147             <substitution_definition names="NoCamelCase">
1148                 <reference name="NoCamelCase" refuri="http://moinmoin.wikiwikiweb.de/ParserMarket/NoCamelCase">
1149                     NoCamelCase
1150                 </reference>
1151             </substitution_definition>
1152             <target ids="project-oekonux" names="project\ oekonux" refuri="http://www.oekonux.de/"/>
1153             <target ids="the-projekt-mailing-list" names="the\ projekt\ mailing\ list" refuri="http://www.oekonux.de/projekt/liste/"/>
1154             <target ids="mediawiki" names="mediawiki" refuri="http://wikipedia.sourceforge.net/"/>
1155             <target ids="moinmoin" names="moinmoin" refuri="http://moinmoin.wikiwikiweb.de/"/>
1156             <target ids="restructuredtext" names="restructuredtext" refuri="http://docutils.sourceforge.net/rst.html"/>
1157             <target ids="latex" names="latex" refuri="http://www.latex-project.org/"/>
1158             <target ids="nocamelcase" names="nocamelcase" refuri="http://moinmoin.wikiwikiweb.de/ParserMarket/NoCamelCase"/>
1159             <comment xml:space="preserve">
1160                 LocalWords:  diffs CamelCase InterWiki MoinMoin rst projekt MediaWiki aka
1161             </comment>
1162             <comment xml:space="preserve">
1163                 LocalWords:  Wikipedia PageList WikiWords reStructuredText
1164             </comment>
1165             <comment xml:space="preserve">
1166                 LocalWords:  Wikis NoCamelCase
1167             </comment>
1168         </section>
1169     </section>
1170 </document>