summaryrefslogtreecommitdiffstats
path: root/documentationdemands.mdwn
diff options
context:
space:
mode:
authorGustav Eek <gustav.eek@proceranetworks.com>2013-07-18 17:52:42 +0200
committerGustav Eek <gustav.eek@proceranetworks.com>2013-07-18 17:57:23 +0200
commit7e650c88419d42bfc12ddf4dcaabacef24fccb4f (patch)
treec3e84c7b699a45d63c83935c72a40a8fa95e955d /documentationdemands.mdwn
parent3fe49e33015dae59f3be03935961fac8a5f040e7 (diff)
Notes from July 11 added: Documentation discussion
Diffstat (limited to 'documentationdemands.mdwn')
-rw-r--r--documentationdemands.mdwn33
1 files changed, 33 insertions, 0 deletions
diff --git a/documentationdemands.mdwn b/documentationdemands.mdwn
new file mode 100644
index 0000000..e6b79fd
--- /dev/null
+++ b/documentationdemands.mdwn
@@ -0,0 +1,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.
+
+
+