Skip to contentSkip to conversation

Status of ALSA documentation?

DISCUSSION Patrick Shirkey 2 participants 2 messages Feb 27, 2002

lore
Share & tools
lore
#0 lore raw

Paul sent me a revised edition of the alsa home page with more of a current feel than the previous version so you can find it here:

http://www.boosthardware.com/LAU/alsa/index4-pd.html

I have retained the link to the LAU-guide because I know it helps new users to find needed information. However for those of you who are anti my link to Boost Hardware being so prominent I have restructured the page slightly.

I intend to start getting in knee deep on the alsa-howto wiki which Mark created.
Once that is in more of a working condition I will add that and the new midi howto (at the linux doc project) to the LAU-guide too.

I will also attempt to create a docbook version of all the info in the alsa-howto wiki. Once I get cosy with docbook markup.

--
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

_____________________________________________________________
You deserve a better email address! Get personalized email @yourname or @yourcompany from Everyone.net --> http://www.everyone.net?tag

_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel

#1 lore raw
Quoted 4 lines

Paul sent me a revised edition of the alsa home page with more of a current fe el than the previous version so you can find it here:

http://www.boosthardware.com/LAU/alsa/index4-pd.html

a few questions/comments on the new one.

1) is a requirement that the SuSE logo be where it is?

2) i think that we should come up with a consistent design for all the ALSA pages. that probably means making the LHS navigation bar smaller, removing extraneous logos (i don't think we need the SF logo here - this is not hosted by sf.net), remove the "statistics" links etc. I would personally get rid of the image based navigation bar and use text instead. see equalarea.com for an example of what i mean (and buy the CD if you feel like it! :)

3) the document at alsa-project.org/api.php3 contains zero links to the current API documenation. its critical that this be in place. I like the layout, have some ideas for improvements. I don't know where the current docs live - the current "Documentation" link is dead.

4) I would be happy to work on the API documentation "index" page if someone will tell me where I can find the current one. I will rework it to be a combination of the current api.php3 and the new stuff, and make it friendly toward people coming to ALSA for the first time. This page should not, IMHO, be generated by docbook, even though the rest of the ALSA API pages will be.

--p

_______________________________________________
Alsa-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/alsa-devel