Daniel Gonçalves <dan...@...> writes: > > Hello, > Why not use ReST [1] (Restructured Text) using the excelent Sphinx [2] > documentation tool. These are the tools used to document the Python > project [3][4]. > If I can help in any way, I'm available and very insterested in a > better/accessible Harbour documentation. > > [1] http://docutils.sourceforge.net/rst.html > [2] http://sphinx.pocoo.org/ > [3] http://www.python.org/ > [4] http://docs.python.org/library/index.html > > In the page [4], look at the "Show source" link on the left, to see > how the source documents looks like. > > Regards, >
hello Daniel, 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. regards, --- Pete _______________________________________________ Harbour-users mailing list (attachment size limit: 40KB) [email protected] http://lists.harbour-project.org/mailman/listinfo/harbour-users
