Dr Andrew C Aitchison writes: > For documentation, just submit changes to [EMAIL PROTECTED] > If you are doing it seriously, consider installing whatever sgml tool we > are currently using (possibly docbook), since the master sources for > some documentation is in sgml, eg > xc/programs/Xserver/hw/xfree86/doc/README.MGA > is built from > xc/programs/Xserver/hw/xfree86/doc/sgml/MGA.sgml > > I hadn't realized that this file had slipped so far behind > xc/programs/Xserver/hw/xfree86/drivers/mga/mga.man >
For creating or extending README files this may actually be necessary. Although I'd strongly vote for replacing SGML for something less awkward - less meta, more text. In my opinion it is the biggest obstacle in getting people to write documentation. For a FAQ it is clearly overkill. I'd suggest to start with something simple. I just checked: we have a wiki set up which hasn't been used at all so far. My suggestion is to use the Wiki to get started on an FAQ. It can be amended and modified by more than one person. Once entries have become stable they can be set up to be read only. For the beginning I'd suggset to watch the xfree86@ maling list and see what are the most common problems - and their solution. > > Sending an email to [EMAIL PROTECTED] does not seem to have resulted in > > anything :) > > I get the feeling that the "management" would rather spend the time > receiving and integrating submitted documentation than registering people > who are interested in doing something. Hm, atually the few people involved in committing patches don't find the time to do anything else any more. Egbert. _______________________________________________ XFree86 mailing list [EMAIL PROTECTED] http://XFree86.Org/mailman/listinfo/xfree86
