Hey Martin, On Sep 27, 2012, at 5:10 AM, Martin Desruisseaux wrote:
> One more material that we could include if peoples wish is a documentation > that I started in DocBook format. For now it is in French, but the plan was > to translate it to English when it would be advanced enough (it may take one > year): > > http://www.geotoolkit.org/book/fr.xhtml > > I'm writing this a little bit like a book. The current content just explains > the relationship with standards. Is there an interest to transfer this > document to SIS? If so, is the DocBook format okay? (if alternative formats > is proposed, I would still like a format that allow to express mathematical > formulas in a better way than PNG images...). Wow that looks great! Yep I'm interested in transferring this to SIS. I see SIS evolving as a combination of the core QuadTree + Location Service that we built + all the GeoAPI and GeoTK stuff you guys were doing, incrementally merging and becoming Apache SIS here. As such I think we can bring this guide over and reduce the amount of duplicative effort you have to do, and hopefully get some folks in Apache SIS land here helping out. > > About the relationship with CMS: actually I have no experience at all with > CMS, so I could not tell... But maybe the two can be complementary. I like to > keep technical documentation under the SVN trunk, because if I change a > class, a search for the classname on trunk will list usages in both code and > documentation. Documentation outside "trunk" are less likely to be updated > (at least in the way I tend to work...). However documents about general > presentation, news, events or thing like that are probably better to be on a > CMS. > Yeah I think they are complementary. I think we can evolve this guide via either Maven (including it via DocBook) since Maven and the CMS play together per my prior email or we can maintain it strictly in CMS ville either way is fine with me. Thanks! Cheers, Chris ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Chris Mattmann, Ph.D. Senior Computer Scientist NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA Office: 171-266B, Mailstop: 171-246 Email: [email protected] WWW: http://sunset.usc.edu/~mattmann/ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Adjunct Assistant Professor, Computer Science Department University of Southern California, Los Angeles, CA 90089 USA ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
