http://ayende.comAyende @ RahienCopyright (C) Ayende Rahien 2004 - 2021 (c) 202660Michael/Torkel, that's stuff for a book, not screencasts. It's just too many things involved. Ayende, not sure I did. I really googled a lot for it. I believe my problem was handling things with no return value. Took a while to get to LastCall and understand how I was supposed to use it. But I might be getting old.... http://ayende.com/2602/documentation-contributions#comment11http://ayende.com/2602/documentation-contributions#comment11Thu, 28 Jun 2007 20:52:13 GMTDonate it to poors... http://ayende.com/2602/documentation-contributions#comment10http://ayende.com/2602/documentation-contributions#comment10Thu, 28 Jun 2007 12:13:52 GMTI agree with Mike, seeing the process of building a real world application is to me most help full in understanding how a framework should/can be used. http://ayende.com/2602/documentation-contributions#comment9http://ayende.com/2602/documentation-contributions#comment9Thu, 28 Jun 2007 06:02:32 GMTMichael, That is what I am doing now with the Hibernating Forums stuff. It has a different focus, but it should do to teach how you can use that. http://ayende.com/2602/documentation-contributions#comment8http://ayende.com/2602/documentation-contributions#comment8Thu, 28 Jun 2007 05:22:21 GMTHammett, did you get a chance to see the Hibernating Rhinos #1 ? http://ayende.com/2602/documentation-contributions#comment7http://ayende.com/2602/documentation-contributions#comment7Thu, 28 Jun 2007 05:20:46 GMTWhat I would love to see from Castle (and may other larger frameworks) is a separate project which goes through the construction of a complete application from beginning to end. The project would have screencasts of important topics and a blog where contributors can talk about their experience. This is likely going to be very time-consuming and so I don't think it is up to the core contributors of the project to do the actual work here. Also I don't think that $500 would cover it. What it would do is increase the public exposure of the framework. It might even cause a media ruckus :) http://ayende.com/2602/documentation-contributions#comment6http://ayende.com/2602/documentation-contributions#comment6Thu, 28 Jun 2007 02:39:14 GMTI had some hard time getting up to speed with Rhino.Mocks, so I think a getting started would be useful. But who am I to complain about documentation? ;-) http://ayende.com/2602/documentation-contributions#comment5http://ayende.com/2602/documentation-contributions#comment5Thu, 28 Jun 2007 01:41:13 GMT@Brennan, All projects already have a wiki or equivalent Castle has http://using.castleproject.org - which is confluence NHibernate has the JBoss' system Rhino Tools has http://www.ayende.com/Wiki - ScrewTurn wiki I am more interested in getting content created than the mechanics of that. http://ayende.com/2602/documentation-contributions#comment4http://ayende.com/2602/documentation-contributions#comment4Wed, 27 Jun 2007 21:45:39 GMTPerhaps the best thing you could do is purchase a very good wiki like Confluence. Since you are already running a popular open source project you can probably get a free license anyway. http://www.atlassian.com/software/confluence/ The ease of use of their wiki actually makes writing up new documentation a breeze. It also indexes all kinds of document formats like Word and PDF and makes it all searchable. If you can get a free license you could spend the $500 on graphic designer to ensure everything looks great and is very readable. A good layout designer is worth the money, although $500 is not exactly a ton of money. http://ayende.com/2602/documentation-contributions#comment3http://ayende.com/2602/documentation-contributions#comment3Wed, 27 Jun 2007 21:30:16 GMTWhat about getting all those 500$ changed to the lowest-value-coin-you-can-find (with up to 3 queries), and then write a huge I-(^^)-NHibernate through the Grand-Canyon? No that's evangelizing !! http://ayende.com/2602/documentation-contributions#comment2http://ayende.com/2602/documentation-contributions#comment2Wed, 27 Jun 2007 20:51:20 GMTSample projects are by far most helpful for me . Castle has some but they are often out of date (for example, trying to learn Brail is better with your sample application and not the castle samples). NHibernate has a few good samples out there but I don't really agree with the way they consume NHibernate services since they focus on how NHibernate works rather than how NHibernate integrates into an app. I am not sure how money would produce this unless you pay someone to commit to a day or two to create sample projects with a variety of structures and setups using these tools. I want to do just that but time keeps me from following through. http://ayende.com/2602/documentation-contributions#comment1http://ayende.com/2602/documentation-contributions#comment1Wed, 27 Jun 2007 20:40:29 GMT