Generating documentation out of the source has the advantage of: 1) being easy to keep accurate 2) encouraging people to comment their work in the source
-Will On Thu, Mar 19, 2009 at 9:55 AM, Stephen Bohlen <[email protected]> wrote: > I will step up to this task; I agree 100% with your point. > > As I am intrigued by comparing the viability of this other (non-DocProject) > approach and am already familiar with the DocProject system, I will do this > and report results of my comparison. > > -Steve B. > > ________________________________ > From: Fabio Maulo > Date: Thu, 19 Mar 2009 13:46:08 -0300 > To: <[email protected]> > Subject: [nhibernate-development] Re: Docu > > Ok. > Who have time to study each possible solution, present pro-cons here in > dev-list, and then implement all needs before NH2.1.0GA ? > Few months ago I was asking for the remotion of "Documentation" folder; I > don't remember who, but somebody said "no please" but after that there was > no commits related to that folder. > What I mean is : from a user we can accept a proposal and a JIRA but from a > team member we should expect proposal and time to spent on it. > Somebody available to accept this task ? > > 2009/3/19 Stephen Bohlen <[email protected]> >> >> That's an interesting project; FYI my company has successfully used with >> repeated results the DocProject VS toolset available right here... >> >> http://www.codeplex.com/DocProject >> >> The advantage of this approach is that its output format isn't limited to >> just one output type (web-based HTML help) but can also produce CHM content, >> VS-integrated help content (for folding into F1-help in VS), and others. >> >> Just an alt suggestion to consider... >> >> -Steve B. >> >> On Thu, Mar 19, 2009 at 11:14 AM, Fabio Maulo <[email protected]> >> wrote: >>> >>> 2009/3/19 Will Shaver <[email protected]> >>>> >>>> >>>> http://blog.jagregory.com/2009/03/19/introducing-docu-simple-doc-gen-for-net/ >>>> >>>> Should we do something like this for nhforge? Seems easy enough... >>> >>> Yes we can. >>> >> >> >> >> -- >> Steve Bohlen >> [email protected] >> http://blog.unhandled-exceptions.com >> http://twitter.com/sbohlen > > > > -- > Fabio Maulo >
