1 |
On Sun, 4 Apr 2010 00:31:52 -0700, Joshua Saddler |
2 |
<nightmorph@g.o> wrote: |
3 |
|
4 |
> |
5 |
> No, he's definitely out to kill GuideXML. Just give him time. |
6 |
> |
7 |
|
8 |
At least for official documentation, that should not happen. |
9 |
|
10 |
(That excludes non-doc parts of the website though imo. GuideXML is a |
11 |
XML "DSL" designed for documentation, sadly it sucks for doing |
12 |
websites.) |
13 |
|
14 |
> > A wiki can fulfill several purposes for us: |
15 |
> > |
16 |
> [...] |
17 |
> |
18 |
> However, a wiki *does* make it easier for everyone to jump right in |
19 |
> and edit stuff as ideas are passed around, rather than waiting for |
20 |
> someone to make changes to something in a devspace. |
21 |
> |
22 |
|
23 |
That's why we should want a wiki for general collaboration. |
24 |
|
25 |
> > 3. A place to host and maintain our existing documentation |
26 |
> > [which is currently in GuideXML] |
27 |
> |
28 |
> Entirely unnecessary duplication of effort. To quote the forum mods, |
29 |
> "don't cross-post" . . . and especially don't do it if you'll be |
30 |
> violating a doc license somewhere. It's one of the reasons why we |
31 |
> don't use existing unofficial wiki content in our docs. I and the GDP |
32 |
> have written about that ad nauseum over the years; just search the |
33 |
> list archives. |
34 |
|
35 |
ack. It should /not/ be a goal of the Wiki to maintain official docs. |
36 |
|
37 |
> [...] |
38 |
> Show me a wiki that produces such beautiful code samples (with |
39 |
> titles). |
40 |
> [...] |
41 |
> . . . or a wiki that makes it super-easy to add all sorts of |
42 |
> additional in-line formatting to regular paragraphs, for example all |
43 |
> the blue highlighting for code used throughout |
44 |
> http://www.gentoo.org/doc/en/xml-guide.xml, or the monospace font |
45 |
> used for filesystem paths. |
46 |
> |
47 |
|
48 |
Let's be honest: Such things can be arranged. Most Wikis have a {{foo}} |
49 |
-> <tt>foo</tt> syntax already built in. |
50 |
|
51 |
> Show me a wiki that makes it easy to create tables, for example, |
52 |
> compare RadeonProgram from the x.org wiki: |
53 |
> |
54 |
> http://www.x.org/wiki/RadeonProgram?action=edit |
55 |
> |
56 |
> ||<-2 style="text-align: center; background-color: #666666"> |
57 |
> '''Native''' ||<style="text-align: center; background-color: |
58 |
> #666666"> '''R100''' ||<style="text-align: center; background-color: |
59 |
> #666666"> '''R200''' ||<style="text-align: center; background-color: |
60 |
> #666666"> '''R300''' ||<style="text-align: center; background-color: |
61 |
> #666666"> '''R400''' ||<style="text-align: center; background-color: |
62 |
> #666666"> '''RS690''' ||<style="text-align: center; background-color: |
63 |
> #666666"> '''R500''' ||<style="text-align: center; background-color: |
64 |
> #666666"> '''R600''' ||<style="text-align: center; background-color: |
65 |
> #666666"> '''R700''' || |
66 |
> |
67 |
> |
68 |
> . . . that's one line of cells. One. Ugly. Compare it to: |
69 |
> |
70 |
> http://www.gentoo.org/doc/en/xml-guide.xml#doc_chap5_pre1 |
71 |
> |
72 |
> <table> |
73 |
> <tr> |
74 |
> <th>Foo</th> |
75 |
> <th>Bar</th> |
76 |
> </tr> |
77 |
> <tr> |
78 |
> <ti>This is an example for indentation</ti> |
79 |
> <ti>more stuff</ti> |
80 |
> </tr> |
81 |
> </table> |
82 |
> |
83 |
|
84 |
Meep. That's an unfair one. |
85 |
The guidexml snippet does not contain any styling. (Oh wait, I forgot, |
86 |
it doesn't even support styling. [another reason why it sucks for |
87 |
websites]) |
88 |
|
89 |
> [...] |
90 |
> |
91 |
> I ain't out to stop ya'll from using a wiki. I do agree that they |
92 |
> have some advantages. However, I will point out how limited wikis |
93 |
> are. They're not a magic bullet that will solve all our problems. |
94 |
|
95 |
Again: Official docs should not be considered as Wiki material indeed. |
96 |
Of course if someone feels like experimenting with such things in the |
97 |
Wiki, feel free to. If the experiment should be really successful, the |
98 |
GDP might reconsider. |
99 |
But it's still the GDP's sandbox and as long as they're playing in it, |
100 |
don't take away their toys. |
101 |
|
102 |
Let's work *together* towards a better Gentoo, so let's consider the |
103 |
official docs off-limits for the Wiki effort (at least for now) as |
104 |
there are valid reasons against such a thing. |
105 |
|
106 |
Alex |
107 |
|
108 |
-- |
109 |
Alex Legler | Gentoo Security / Ruby |
110 |
a3li@g.o | a3li@××××××××××.de |