[LAD] Linux Audio Documentaion Effort : (Was "Question 0")

[Harry van Haaren]

Following recent emails on list about documentation and learning "Linux
Audio Programming", I've been thinking about an effort to help people get
started with Linux Audio Coding.

I think some "beginner" coding documentation on Linux Audio would be a
great asset to the community, and I'm willing to contribute to such an
effort. As Robin Gareus mentioned in another thread, a "FLOSS" manual is
probably the best way to go for a community effort on documenting.

I've been doing some "tutorial" style  programming articles on my blog
harryhaaren.blogspot.com and I'd have no problem sharing the examples there
(some basic GTK stuff, some small JACK apps, combining the GUI / JACK stuff
). Problem is that I was learning as I was going along, and there are some
*fundamental* issues with some of the tutorials (especially with regards to
thread safe code & more advanced programming concepts)

Personally I'd be even more enthusiastic about such an effort if some of
the veteran Linux audio guys were to get on board and ensure the content is
of a high quality. (As I'm a self though programmer, there are some big
gaps in my knowledge, and I'd not like to provide bad sample code, or share
bad concepts.)

Of course some issues will arise in choosing how to document Linux Audio,
and some typical "flame" topics like GUI toolkits, libraries etc will
arise. I have no idea how we can best avoid that issue, except by following
the "if you think it should be thought that way write the tutorial"...  the
downside of this is that if one tutorial uses toolkit <X> and the next
toolkit <Y>, the average beginning coder is going to get lost in
implementation details and that defeats the purpose of documentation :D

-Harry
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.linuxaudio.org/pipermail/linux-audio-dev/attachments/20111128/19987fa9/attachment.html>