On 11/8/06, Dominick Accattato <[EMAIL PROTECTED]> wrote: > However... if I write it, I'm pointing fingers at you to read it! :) > >
lol. It would be my pleasure. But by the way, I really think a getting started guide could be pretty short. The document you pointed me too in the last email was very pretty but really ambitious. I think for now you could just cover. 1. turning it on and setup 2 a page or two on theory of operation. Not about servlets, but scopes and other red5 concepts from a layman's perspective. 3. A few walk throughs of simple hello world apps for like a simple recorder and a simple chat. It could mirror the similar documentation for the equivalent apps that come with FMS. Their doc gives some good examples of how to write simple apps. The big difference is that there is a differences in the red5 metaphor and writing in java and the FMS metaphor and writing in as1. In fact, if this task was parcelled out, one person writing about setup, another, doing theory/conceptual overview, and then two people documenting two simple demo apps you could really have something. It would be really great, and no one would have to feel burdened. Just a thought. Regards Hank > > On 11/8/06, Dominick Accattato <[EMAIL PROTECTED]> wrote: > > > > Hank, I think we all know what needs to be done. Its difficult when we > hear it because its painfully obvious, but the lack of simple documentation > is troublesome. I don't want to commit myself to anything, but I'll try and > get a few pages together. > > > > Here was a quick mock up I did back during 0.3, but I never actually put > much into completing sections. > > > > > http://www.newviewnetworks.com/nvnhome/blog/client/media/Red5%20Manual%200.3.swf > > > > > > On 11/8/06, hank williams <[EMAIL PROTECTED] > wrote: > > > > > 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 > > > > > > > > > > > -- > > Dominick Accattato, CTO > > New View Networks > > www.newviewnetworks.com > > > > -- > Dominick Accattato, CTO > New View Networks > www.newviewnetworks.com > _______________________________________________ > Red5 mailing list > [email protected] > http://osflash.org/mailman/listinfo/red5_osflash.org > > > _______________________________________________ Red5 mailing list [email protected] http://osflash.org/mailman/listinfo/red5_osflash.org
