David Lyon wrote:
>
> On Wed, 11 Mar 2009 09:55:00 -0700, Tim Roberts <timr@probo.com> wrote:
>
>> Delphi and VB are products that cost a thousand dollars or more..
>>
>
> So what.... python is better...
>
Yes, but that's not the point. The point is that, because they charge
thousands of dollars for their products, Borland and Microsoft can
afford to have teams of technical writers on staff, separate from the
developers, who do nothing but write documentation. On a project like
wx, there ARE no technical writers. What we have are programmers
helping other programmers, for free. Those programmers are ALWAYS more
interested in the next fascinating tweak to the code, not in writing
documentation, and most developers really want it to remain that way.
Do you see what I'm saying? Commercial products have documentation
because the companies can afford to pay writers and programmers at the
same time, so development doesn't lag. An open source project doesn't
have that luxury.
By the way, I don't want you to think that I'm disagreeing with you in
any major way. I'm merely trying to point out why things are the way
they are, and why it is very natural for it to be this way in this kind
of a project.
>> I'm not sure that's a productive use of time.
>>
>
> So where is the documentation time being allocated ?
>
This little sentence makes so many assumptions! You assume that (a)
there is "documentation time" to be allocated, that (b) there is a
master project plan that has schedules for this kind of thing, and that
(c) there is some project manager who is doing the scheduling and
distributing assignments. Again, you WOULD have all that inside Borland
and Microsoft, but not in a project like wx. It is much more ad hoc.
>> It is
>> very difficult to overestimate the incredible amount of time and effort
>> this requires, and for now most of would rather that the people who CAN
>> invest that time effort remain focused on programming.
>>
>
> You mean underestimate....
>
No! It is VERY easy to underestimate the effort needed for good
technical documentation. Take your estimate, and multiply it by 3.
> I'm getting too old to program... I want to write more documentation...
>
Believe me, there are a vast number of open source projects who would
dearly love to have someone like you on their team...
--
Tim Roberts, timr@probo.com
Providenza & Boekelheide, Inc.
_______________________________________________
wxpython-users mailing list
wxpython-users@lists.wxwidgets.org
http://lists.wxwidgets.org/mailman/listinfo/wxpython-users
-->