summaryrefslogtreecommitdiffstats
path: root/documentationdemands.mdwn
blob: 7312f523c330178e1d5242ec687f8dcfe2133692 (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
Documentation Demands
=====================

There is a need for a rework of the technical documentation of Fripost
email and network solutions. July 11, Leif-Jöran, Guilhem, and Gustav
recognised the demands on a technical documentation that are covered
by this article.

**General demands**

* Fripost should avoid many different systems: preferably the
  association's homepage, wiki, and documentation solution should be
  the same.

**Demands for reading**. The solution should be

* Index-able by Internet search engines
* Locally search-able, from within the solution
* Available in several potential reading formats
* Readable of line, which is being _less_-friendly (_more_-friendly)

**Demands on writing and contributions**. The solution should be

* Open for more than administrators to contribute
* Comment-able from also non members
* Reasonable efficient to edit offline from regular text editors

Questions to be answered
------------------------

Does _Gitolite_ have support for LDAP? That way _ikiwiki_ could be
coupled to layers of access: administrators, members, and all.