Moving back to .NET
Chris via Digitalmars-d
digitalmars-d at puremagic.com
Mon Sep 28 07:40:01 PDT 2015
On Saturday, 26 September 2015 at 00:28:19 UTC, Jonathan M Davis
wrote:
> A lot of folks write code because they want to get something
> done and simply because they like coding. Publicizing it isn't
> necessarily particularly important to them. They may want to
> make it open source so that others can use it if they're so
> inclined, but that's frequently not the goal. And even when
> they _do_ want to make a big deal out of something, coding is a
> lot more interesting than writing documentation, and there's
> always more code to write, so it can be pretty easy to leave
> documentation by the wayside. Most programmers consider
> documentation to be a chore, even when they're really excited
> about what they did. In general, I wouldn't expect someone to
> even open source something if the problem was that they were
> ashamed about how they did it. I fully expect that in the vast
> majority of cases when code is available but not well
> documented, it's because the programmer didn't have the time to
> do it or didn't want to spend the time doing it. This is the
> first time that I've ever heard anyone suggest that it was due
> to shame about the code.
>
> - Jonathan M Davis
And don't forget that there are also the unit tests. Once they
are written they are documentation + example in one. I often find
myself looking at the unit tests in Phobos to see how things
work, when in doubt.
More information about the Digitalmars-d
mailing list