From mboxrd@z Thu Jan  1 00:00:00 1970
From: Takashi Iwai <tiwai@suse.de>
Subject: more improvement of alsa web pages
Date: Wed, 24 Apr 2002 11:31:01 +0200
Sender: alsa-devel-admin@lists.sourceforge.net
Message-ID: <s5hd6wph296.wl@alsa2.suse.de>
Mime-Version: 1.0 (generated by SEMI 1.14.3 - "Ushinoya")
Content-Type: text/plain; charset=US-ASCII
Return-path: <alsa-devel-admin@lists.sourceforge.net>
Errors-To: alsa-devel-admin@lists.sourceforge.net
List-Help: <mailto:alsa-devel-request@lists.sourceforge.net?subject=help>
List-Post: <mailto:alsa-devel@lists.sourceforge.net>
List-Subscribe: <https://lists.sourceforge.net/lists/listinfo/alsa-devel>,
	<mailto:alsa-devel-request@lists.sourceforge.net?subject=subscribe>
List-Unsubscribe: <https://lists.sourceforge.net/lists/listinfo/alsa-devel>,
	<mailto:alsa-devel-request@lists.sourceforge.net?subject=unsubscribe>
List-Archive: <http://www.geocrawler.com/redir-sf.php3?list=alsa-devel>
To: alsa-devel@lists.sourceforge.net
List-Id: alsa-devel@alsa-project.org

Hi,

first of all, kudos to Patrick;  the new appearance is really good!


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.

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?


Takashi