From: Patrick Shirkey Subject: Re: more improvement of alsa web pages Date: Wed, 24 Apr 2002 05:46:07 -0700 (PDT) Sender: alsa-devel-admin@lists.sourceforge.net Message-ID: <20020424124607.B151C36F9@sitemail.everyone.net> Reply-To: pshirkey@boosthardware.com Mime-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: 7bit Return-path: Content-Disposition: inline Errors-To: alsa-devel-admin@lists.sourceforge.net List-Help: List-Post: List-Subscribe: , List-Unsubscribe: , List-Archive: To: Takashi Iwai , alsa-devel@lists.sourceforge.net List-Id: alsa-devel@alsa-project.org --- Takashi Iwai wrote: >Hi, > >first of all, kudos to Patrick; the new appearance is really good! > Thanks. > >now i have a proposal. > >how about to add informational pages for each driver, and make links >from soundcard matrix? then a user can reach to the detailed info by >two clicks from the top page. > It's a good idea which we discussed when people were working on the howto wiki a couple of months back. >a driver page will contain: > >- supported and tested hardwares > >- detailed description, including module parameters and > supported/unsupported features > >- known bugs (and workarounds if any), TODO > >- links to other resources, such as howto's > > >the pages should be controlled by cvs, so that both developers and web >admins can keep them up-to-date. >an advantage is that we can generated documents for >alsa-kernel/Documentation from these files. > >i'm not sure whether these docs to be auto-generated or should be >static files. also, we need to discuss which format is best - sgml, >docbook, html or else. > >we can start from converting existing docs (e.g. CMIPCI.txt) to >such pages. > > >any comments please? > I can draft a template page in html over the next few days. Keeping in line with the new format style. -- Patrick Shirkey - Boost Hardware Ltd For the discerning hardware connoisseur Http://www.boosthardware.com Http://www.boosthardware.com/LAU/Linux_Audio_Users_Guide/ _____________________________________________________________ Want a new web-based email account ? ---> http://www.firstlinux.net _____________________________________________________________ Run a small business? Then you need professional email like you@yourbiz.com from Everyone.net http://www.everyone.net?tag