Re: the .org proposal or "join forces"
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On Tue, 20 Dec 2005 18:55:57 +0100
RalfGesellensetter <rgx@gmx.de> 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-----
Reply to: