Hello Pete! 2010/2/17 Pete <[email protected]>: > I do also have spent some hours examining documentation tools like 'doxygen', > 'LyX' and others, although the ones you have suggested are very good, i'd say > more interesting than those i did refer. But the sure thing is, that they > demand > advanced experience and good usage knowledge to get a good result. and time! > and > the most important, we need well formed/edited texts which is the core > material > of any documentation. On the other hand, i do see that into harbour's website > there are already a lot of documentation pages. perhaps some of the topics > there, are outdated/obsolete due to newer implementation/changes/enhancements > and need revision/correction. but this place and this material could be a good > base point to start (re-)working on documentation. I don't know who is > responsible to maintain these pages, but it's time to ask the webmasters (if > anyone of them is reading this thread), in what way somebody (like > you,me,anyone) willing to help in harbours documentation could involve and > start > working on. Then we could make a plan about specific things that must be done. >
I have a good experience with Sphinx. I also (and always) have a lot to learn about it, no doubt. As I said on a previous post, I will start with the available texts in /harbour/doc and with the documentation texts available in the web site. As soon as I have something (I expect to be 2 or 3 days) I will publish the work for the community to experiment with the sources and the resulting (built) documentation. I guess Massimo, you and others will help me figure out the best way to group topics and with the re-work of the current availble documents. I'm very excited with this project -- I can't wait to start! Regards! -- Daniel Gonçalves Base4 Sistemas Ltda. [www.base4.com.br] [twitter.com/spanazzi] _______________________________________________ Harbour-users mailing list (attachment size limit: 40KB) [email protected] http://lists.harbour-project.org/mailman/listinfo/harbour-users
