One of the things that surprises me here is the value so high that they say has paid for a documentation ... Here in my country know some people who do something for free, or that account for just USD$ 400.00 per month.
I don't know anything about writing or even tech writing fees, so can't really dispute the amount paid by xhb.com, but to me it also seems high.
Another thing that needs to be mentioned is that if you used search tools such as phpdoc, javadoc, doxygen (recognized for their excellence) or even read the sources of Qt will see that these tools produce good documentation from source code, which is not something so absurd to achieve... But as Viktor said is better to help what we separate the translation of sources and I agree with him.
These can only produce good documentation from source, if the source itself contain hand written documentation. These are just extractors and formatters AFAIK. Maybe with some additional logic to recognize certain programming constructs (like params accepted / returned), but that's very very few for a proper documentation.
Like as the xbase++, xHB.COM, dBase, VFP and other tools have their own documentation, I believe the Harbour project is able to produce a material of good quality. We need to think before pay someone to do this, we must consider what other options we have. We have a site for our project that is visually attractive and we not spend with this, we have a hosting server that has been assigned and not pay for this ... Does not anyone have any other idea to submit?
What we can leverage on is that Harbour is 100% compatible with CA-Cl*pper. So, all old documentation already written can be used as is. I'm not sure what are the possibilities to get it, who is the current owner of the rights (GrafXoft?) and would they pass it. Above that only extra Harbour functions and language elements would need to be documented, plus some platform comments added to existing functions where it's needed. MiniGUI also produced and proper documentation, so we could work with them. Since they didn't comment here on any of these propositions, they might not be interested or just not reading this list. We can also widen potential user base, f.e. by offering plugin Xbase++, FlagShip, VFP compatibility, just like we did for C5.x. Brgds, Viktor _______________________________________________ Harbour mailing list Harbour@harbour-project.org http://lists.harbour-project.org/mailman/listinfo/harbour
