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

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