-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Tue, 20 Dec 2005 18:55:57 +0100 RalfGesellensetter <[EMAIL PROTECTED]> wrote:
> Am Dienstag 20 Dezember 2005 14:54 schrieb Jonas Smedegaard: > > Debian has a website: http://www.debian.org/ . Not a CMS, but static > > pages written in Web Meta Language and stored in CVS. This is not > > the easiest way to post content, but remember that we are talking > > about the _development_ here, *not* the school administrators. > > Hi Jonas, > > basically, I agree. But I am afraid it is not easy too draw a clean > cut between developers and users here: > > As for documentation, it's mainly developers who are supposed to > provide it (CVS according to your suggestions). But, in real life, > non-developers, especially advanced users, can conribute a lot to > documentation. The German Wiki is full of such user entries. The way I see it there is "loose" and "strict" documentation. Wiki is very good for loose documentation. You just "throw in" your contributions, and it sticks: Perhaps others adjust it but if not then it is still useful even if messy. Debian web WML code and docbook is more "strict", requiring knowledge of the format to not blow up the structures somehow. You can possibly short-circuit those two, but not always: If the "strictnes" includes keeping track of a reference (like with translations based on a master document) you cannot go get creative and add new stuff to, say, the german version if the master document is english. So for some things it makes sense to ease the gap by writing filters (between docbook format and wiki markup through ReST for example), but sometimes the "gap" is not in storage but in procedures to follow, and requires other tools. Or to summarize: I see a need for both wiki (for all to contribute) and a more STATIC documentation (for developers to maintain based ON the - possibly messy - collective pool of info) that makes distributed translation possible. - Jonas - -- * Jonas Smedegaard - idealist og Internet-arkitekt * Tlf.: +45 40843136 Website: http://dr.jones.dk/ - Enden er nær: http://www.shibumi.org/eoti.htm -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (GNU/Linux) iD8DBQFDqElyn7DbMsAkQLgRAnmWAJwKYeCbyYyeyzg3tO5GnF/+qg7OLACfXey9 kf7aDelbqTtnsasBXgEmRX0= =Aec9 -----END PGP SIGNATURE-----
