On 11/8/06, John Grden <[EMAIL PROTECTED]> wrote: > creating a new app with the new API: > http://www.joachim-bauch.de/tutorials/red5/HOWTO-NewApplications.txt > > Migration guide: > http://www.joachim-bauch.de/tutorials/red5/MigrationGuide.txt > > API online: > http://dl.fancycode.com/red5/api/ > > Does that help? >
Well, not really. The first thing I wanted to do was run the demos. There is no getting started guided. Now, it took me 15 minutes to figure out that red5 comes up on port 5080. Now I bet that is written down somewhere but I couldnt find it. There really should be a getting started guide that explains how to run the darned thing. Now I am a tomcat user, so I was able to look at the text stream from red5 and look for the port. But only someone who is in the tomcat/j2ee world will know how to do that. I bet many people wont get that far. Now, I did look at joachim's new application guide. But its just too hard. Now I'm not saying that I wont ultimately be able to figure it out. But a few well written pages can save someone like me hours, and perhaps others days. The problem is just that the info is **WAY** too terse and assumes understanding of things that one shouldnt assume. For example he starts with a handful of lines that explain globalScope and contextConfigLocation in the web.xml file. Now, honestly, it took me months to get comfortable with the concept of the web.xml file in standard servlet development. And the components and layout of a web.xml is not exactly newbie friendly. Worse yet, he doesnt show a whole, miminal web.xml - just snippets, leaving it to the imagination how the whole thing goes together. Its very confusing. But zooming back a level, this certainly isnt how I would start explaining to a new person how to do a new app or what all of this is about. I could go on and on, but I think you get the idea. This is not an attack on Joachim, but it is a real issue. One of the problems with open source software is that the people that do it are so smart that they dont quite understand how to explain what they are doing to us dummies. This is particularly true with java/backend stuff. I dont understand anything on the apache website! I realize that you are only on .6 and its not really meant for general consumption yet. But explaining how to turn it on, and a getting started guide including how to do a hello world would probably be a very helpful. It would to me anyway. I appreciate the good work that you guys are doing. And while I am not able to contribute development time, I would be happy to provide some structural editing services for documentation. What that really means is I am happy to read the doc and tell you where I am totally confused and why, and to suggest some structure for the doc. I really do think you guys need the help of a few dummies! Regards, Hank _______________________________________________ Red5 mailing list [email protected] http://osflash.org/mailman/listinfo/red5_osflash.org
