Skip to contentSkip to conversation

more improvement of alsa web pages

DISCUSSION Patrick Shirkey 2 participants 2 messages Apr 24, 2002

lore
Share & tools
lore
#0 lore raw
Quoted 4 lines · --- Takashi Iwai

Hi,

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

Thanks.

Quoted 7 lines

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.

Quoted 21 lines

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.

Quoted 6 lines

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 [email protected] from Everyone.net http://www.everyone.net?tag

#1 lore raw

At Wed, 24 Apr 2002 05:46:07 -0700 (PDT),

Quoted 3 lines · Patrick Shirkey

I can draft a template page in html over the next few days. Keeping in line with the new format style.

do you write a bared html or is it generated from a meta format?

Takashi