[Capistrano] Re: Documentation Project

2007-01-14 Thread Rick Olson
I'd be willing to give that a try, though a mephisto account per author feels a bit top-heavy for the community-driven documentation effort I had in mind. Maybe that's what we try first, though. What would it take to set that up? A domain name pointed to the same IP that

[Capistrano] Re: Documentation Project

2007-01-12 Thread NeilW
It might be worth banging this around here for a week or two and see if we can come up with something that is better than a wiki. Is there any particular reason why it can't be done in 'rdoc' in the code base. At least then we can submit patches to it (assuming there is somewhere capistrano

[Capistrano] Re: Documentation Project

2007-01-12 Thread Jamis Buck
The problem with rdoc is it is API-oriented. I'm wanting something that someone new to capistrano could pick up and learn how to use capistrano with. I've not seen an rdoc-generated site that succeeded from that perspective. - Jamis On Jan 12, 2007, at 9:11 AM, NeilW wrote: It might be

[Capistrano] Re: Documentation Project

2007-01-12 Thread Chris McGrath
On 12 Jan 2007, at 16:11, NeilW wrote: It might be worth banging this around here for a week or two and see if we can come up with something that is better than a wiki. Is there any particular reason why it can't be done in 'rdoc' in the code base. At least then we can submit patches to

[Capistrano] Re: Documentation Project

2007-01-12 Thread philippe lachaise
I've not seen an rdoc-generated site that succeeded from that perspective. +1. Most RDoc-generated sites are good at convincing visitors that their efforts at understanding are doomed to failure. Ultimately, I'd like to be able to provide a printable version of the docs, as well as a version

[Capistrano] Re: Documentation Project

2007-01-12 Thread philippe lachaise
Well, look at this : http://deplate.sourceforge.net/index.php An it's Ruby-based by the way ! --~--~-~--~~~---~--~~ To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/capistrano

[Capistrano] Re: Documentation Project

2007-01-12 Thread Faisal N Jawdat
On Jan 12, 2007, at 11:11 AM, NeilW wrote: It might be worth banging this around here for a week or two and see if we can come up with something that is better than a wiki. one alternative might be to set up a documentation repository and handle changes via the standard submit patch - we

[Capistrano] Re: Documentation Project

2007-01-12 Thread Faisal N Jawdat
On Jan 12, 2007, at 12:28 PM, philippe lachaise wrote: +1. Most RDoc-generated sites are good at convincing visitors that their efforts at understanding are doomed to failure. +1. my initial experiences with rails were pretty painful, as i got a giant list of the api and no small nugget

[Capistrano] Re: Documentation Project

2007-01-12 Thread Rick Olson
On 1/12/07, Faisal N Jawdat [EMAIL PROTECTED] wrote: On Jan 12, 2007, at 12:28 PM, philippe lachaise wrote: +1. Most RDoc-generated sites are good at convincing visitors that their efforts at understanding are doomed to failure. +1. my initial experiences with rails were pretty painful,

[Capistrano] Re: Documentation Project

2007-01-12 Thread Jamis Buck
On Jan 12, 2007, at 2:24 PM, Rick Olson wrote: On 1/12/07, Faisal N Jawdat [EMAIL PROTECTED] wrote: On Jan 12, 2007, at 12:28 PM, philippe lachaise wrote: +1. Most RDoc-generated sites are good at convincing visitors that their efforts at understanding are doomed to failure. +1. my