Hi Fabio, As soon as I get a chance to work it in to the NAnt script I'll do that.
The CHM or Help2 versions could be provided as downloads from SourceForge (they could also be built at the same time as the binaries) however an online HTML or ASP.NET version would ideally be hosted from NHForge or another website that can be crawled by Google. The catch is that it runs to about 120Mb. Is there enough space on NHForge? Cheers, Symon. On Mon, Nov 17, 2008 at 8:31 PM, Fabio Maulo <[EMAIL PROTECTED]> wrote: > Hi Symon.Do you can add a patch to one of this two issues ? > http://jira.nhibernate.org/browse/NH-800 > http://jira.nhibernate.org/browse/NH-688 > > Another example about "How help with API doc" is here > http://jira.nhibernate.org/browse/NH-1467 > > 2008/11/17 Symon Rottem <[EMAIL PROTECTED]> > >> I've just generated the API docs successfully from Sandcastle. I'll bung >> them up on my website so people can access them pending another solution in >> the near future. >> >> It should be possible to generate the API docs during the build using >> Sandcastle with NAnt, so I'll take a look at what I can come up with and >> submit a patch for the updated build scripts if I can figure it out. This >> approach will, of course, require that the toolchain for building NHibernate >> will also need Sandcastle as a minimum if you want to build the docs. Is >> this satisfactory? >> >> I'm interested in how the non-API documentation is going to be revision >> controlled as a wiki...does any one have any suggestions? >> >> Cheers, >> >> Symon. >> >> >> On Mon, Nov 17, 2008 at 3:39 PM, distansia <[EMAIL PROTECTED]> wrote: >> >>> >>> Hi Tuna, >>> >>> > You can maintain the wiki(for reference), or write blogs. >>> >>> Ok, but I think that Fabio said that the process should be done more >>> or less this way: >>> - Locate the appropiatte Hibernate (Java) official doc >>> - Copy & Paste into the Wiki (some formatting artifacts will happen, I >>> think) >>> - Change whatever it needs to be changed in order to be a "NH" >>> document >>> >>> I think that Fabio started the process of copy&paste from H (Java) to >>> NH, but I do not know if he finished it (I mean, all the pages). >>> >>> So, my questions are: >>> - What JAVA Hibernate version documentation should we use? >>> - Any hints about copy & paste into the wiki? >>> >>> Once the wiki page is finished, what about the DocBook one? Can it be >>> translated? It has to be a manual process? I ask this because I feel >>> that the two versions should be in sync some way... >>> >>> >>> > API document can be done automatically using the xml comments, that >>> means >>> > that thing should be done by devs. >>> >>> So, nothing to do there, ... yet. >>> >>> >>> Excuse me for asking so many questions, I really want to help with >>> this, but I do not want to do it badly (I need some little advice to >>> begin). I have read so many complains about documentation but nearly >>> nobody of us help with it. >>> >>> Let's start!!!! >>> >>> >>> >> >> >> -- >> Symon Rottem >> http://blog.symbiotic-development.com >> >> >> > > > -- > Fabio Maulo > > > > > -- Symon Rottem http://blog.symbiotic-development.com --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "nhusers" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/nhusers?hl=en -~----------~----~----~----~------~----~------~--~---
