diff options
author | Gustav Eek <gustav.eek@proceranetworks.com> | 2013-07-18 17:52:42 +0200 |
---|---|---|
committer | Gustav Eek <gustav.eek@proceranetworks.com> | 2013-07-18 17:57:23 +0200 |
commit | 7e650c88419d42bfc12ddf4dcaabacef24fccb4f (patch) | |
tree | c3e84c7b699a45d63c83935c72a40a8fa95e955d | |
parent | 3fe49e33015dae59f3be03935961fac8a5f040e7 (diff) |
Notes from July 11 added: Documentation discussion
-rw-r--r-- | documentationdemands.mdwn | 33 | ||||
-rw-r--r-- | index.mdwn | 1 |
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. + + + @@ -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 |