Skip to contentSkip to conversation

Status of ALSA documentation?

DISCUSSION Patrick Shirkey 3 participants 4 messages Mar 2, 2002 – Mar 5, 2002

lore
Share & tools
lore
#0 lore raw

I have had another go at cleaning up the page.

Here's the latest.

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

This is just to get an impression of the layout. Obviously the link buttons need to be changed and resized correctly.

--
Patrick Shirkey - Boost Hardware Ltd
For the discerning hardware connoisseur Http://www.boosthardware.com Http://www.boosthardware.com/LAU/Linux_Audio_Users_Guide/

Quoted 7 lines · --- Juhana Sadeharju
Quoted 3 lines

From: Patrick Shirkey <[email protected]>

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

Please ignore my previous mail, posted minute ago. It looks like my help is not needed at all...

Quoted 6 lines

Juhana

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

_____________________________________________________________
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 1 line

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

there's a bug, because all the main text is invisible in netscape 4.

i've tried to fix it, but i can't deal with automatically generated HTML. the indentation is unreadable - nested tables where inner tables are indented less than outer tables, etc.

i tried ripping out large chunks, and got something, but when i tried to narrow it down, i couldn't.

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

#2 lore raw
In reply to Patrick Shirkey
Quoted 3 lines

Here's the latest.

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

I liked better the version which had the explanation of the project. What were its problems? I.e., why it was taken off?

This new page is too wide. Could the title be broken to two lines? Then title's height would match the height of the logos.

The search tool too makes the page wide. The search utility could be on its own subpage. How often you search the Alsa pages? The search page could also contain the site tree.

The text on the subpage links is not well readable, but I don't know what to do without making the text smaller.

How about this layout:

logo1 two line title logo2

subpage links

Two line explanation........and link to more information

Packages: News:

driver short
<version> explanation

library short
<version> explanation

utilities short
<version> explanation

tools short
<version> explanation

OSS Combat short
library explanation
<version>

Best regards,

Juhana

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

#3 lore raw
Quoted 6 lines
Quoted 3 lines

Here's the latest.

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

I liked better the version which had the explanation of the project. What were its problems? I.e., why it was taken off?

i didn't "take it off". i tried to rewrite it so that it didn't sound as if we were just starting out. ALSA isn't complete, but its hardly in a "still working on the basic design" phase. i thought the text should reflect this so that first-time visitors would get a better feeling for it as a working system. the old description sounded to me like a reflection of where ALSA was a year or two ago.

Quoted 2 lines

This new page is too wide. Could the title be broken to two lines? Then title's height would match the height of the logos.

Sounds good to me.

Quoted 1 line

Two line explanation........and link to more information

I tried hard to write a two line explanation, but I couldn't.

Quoted 1 line

OSS Combat short

^^^^^^^^^^

I think its very VERY VERY important that this not be presented this way. ALSA offers binary OSS compatibility with no modifications needed (except for some OSS-mmap apps like quake) Nothing extra is needed to make them work.

the OSS compat library does a *lot* more than provide OSS compatibility. we need a new name for it that reflects it capabilities (routing OSS apps through alsa-lib).

we do not want anyone imagining they have to relink their apps to get them to work with ALSA, since thats not true.

--p

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