1 |
> 1 - requirements |
2 |
> ================ |
3 |
> |
4 |
> In order to choose the best possible wiki implementation, we need to |
5 |
> know our requirements. So what features do you think are essential or |
6 |
> good to have? What syntax would we prefer to use? |
7 |
> |
8 |
> I myself am a big fan of reStructuredText, which is quite simple, |
9 |
> easy to pick up, highly readable, and has a good featureset. Plus, it |
10 |
> is also reusable in other contexts (it is for example widely used in |
11 |
> documentation of Python libraries). MediaWiki, MoinMoin and Trac have |
12 |
> support for rst. |
13 |
|
14 |
I'm not overly concerned about what wiki we use. But may I suggest we |
15 |
approach gentoo-wiki to see whether they would like to be involved. |
16 |
|
17 |
> |
18 |
> Some others: |
19 |
> |
20 |
> - active upstream (bug fixes, security updates) |
21 |
> - free open source software |
22 |
> - ACLs |
23 |
> - spam prevention measures |
24 |
> - attachments (to upload screenshots for example) |
25 |
> - feeds |
26 |
> |
27 |
> Other distros and open source projects surely have had the same |
28 |
> considerations. Can we find out and learn from them? |
29 |
> |
30 |
> |
31 |
> 2 - maintainers |
32 |
> =============== |
33 |
> |
34 |
> Who is volunteering for maintaining the wiki? We need editors and |
35 |
> moderators, people who look out for quality control and take care of |
36 |
> spam removal. So let's get together a team. I'm sure if we ask on the |
37 |
> forums we'll get some users interested as well. |
38 |
|
39 |
I would like to help as I may. Hopefully we can get a good body of users to |
40 |
help as well. I'm of the firm belief that it will be users who should make |
41 |
this idea either fly or crash down hard. Dev's have official means of |
42 |
documenting stuff. |
43 |
|
44 |
> |
45 |
> |
46 |
> 3 - edit access |
47 |
> =============== |
48 |
> |
49 |
> Do we keep to the original "free for all" model, with all the spam |
50 |
> that includes, or do we go with registered users only? I think the |
51 |
> latter is the smarter option. I also think we will want to mark |
52 |
> certain pages "official" and lock down editing rights. |
53 |
> |
54 |
|
55 |
Registered users only please. |
56 |
|
57 |
> |
58 |
> Is there anything else we should consider before getting started? |
59 |
|
60 |
What project should we create this under. |
61 |
|
62 |
gdp is for official documentation so I don't think it should be under that but |
63 |
it could very well be under userrel. Or it could be a new project. |
64 |
|
65 |
I also have some other ideas that I would like to implement once I get around |
66 |
to brain-dumping them. So I will simply ask this question. |
67 |
|
68 |
Are there any complimentary services we could offer users besides a wiki? |
69 |
Maybe best to just think about this and not answer it here. |
70 |
|
71 |
> |
72 |
> Cheers, |
73 |
|
74 |
Alistair |