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 --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
