summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentationdemands.mdwn33
-rw-r--r--index.mdwn1
2 files changed, 34 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.
+
+
+
diff --git a/index.mdwn b/index.mdwn
index 139222f..d823516 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -23,6 +23,7 @@ Välkommen till Friposts medlemswiki!
# Tekniskt
* [[Hemsidan]] – hur den fungerar
+* [[Dokumentationskrav|documentationdemands]] – krav på lösning för tekninsk dokumentation
# Övrigt