summaryrefslogtreecommitdiffstats
path: root/documentationdemands.mdwn
blob: e6b79fd8cbbf5afae005705365a7193fb00cdf6a (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
# 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.