From mboxrd@z Thu Jan 1 00:00:00 1970 From: Takashi Iwai Subject: Re: ALSA docs Date: Fri, 19 Jul 2002 19:39:17 +0200 Sender: alsa-devel-admin@lists.sourceforge.net Message-ID: References: <3D383BAA.9050106@boosthardware.com> Mime-Version: 1.0 (generated by SEMI 1.14.3 - "Ushinoya") Content-Type: text/plain; charset=US-ASCII Return-path: In-Reply-To: <3D383BAA.9050106@boosthardware.com> Errors-To: alsa-devel-admin@lists.sourceforge.net List-Help: List-Post: List-Subscribe: , List-Unsubscribe: , List-Archive: To: Patrick Shirkey Cc: alsa-devel@lists.sourceforge.net List-Id: alsa-devel@alsa-project.org 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