Re: ALSA docs

[Takashi Iwai <tiwai@suse.de>]

At Sat, 20 Jul 2002 01:17:46 +0900,
Patrick Shirkey wrote:
> 
> I'm in the process of reading up about different ways of setting up the 
> new alsa docs so that they are in the style of the new website design 
> and have the look and feel of current documentation on other websites.
> 
> I'm using the online manual for http://www.php.net as the design basis.
> 
> Before I spend any more time on coding up a dynamic user 
> maintained/contributed site what is the general consensus on allowing 
> contribution to the documentation from anybody?
> 
> I have an almost fully working setup now which will allow users to 
> contribute ideas and helpful hints. The problem I now face is whether or 
> not to automate the input or filter it by having it sent to me (or other 
> people) so I/we can post it at our discretion.
> 
> I note that a lot of sites that seemed to originally have allowed input 
> from users to be automatically added to their webpages have decided to 
> change their policy to filtering due to spam or misleading information 
> being posted.

imo, the documents on the "official" web site should be reviewed and
moderated.  one reason is to keep the contents technically correct,
and another is to keep the consistency of the page design (and
to avoid possible spam problems as you mentioned above, of course).

for auto-generated documents, we already have wiki.
isn't it enough?
i've been very impressed by the convenience of wiki.


well, if you think it's too much for you to moderate the input from
users, then i don't mind to change this policy.


Takashi


-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf