Re: software design clarification

David Abrahams <[email protected]> Fri, 07 Mar 2008 11:36:10 -0500
Newsgroups gmane.comp.documentation.synopsis
Message-ID <[email protected]>
on Thu May 03 2007, Markus Elfring <Markus.Elfring-AT-web.de> wrote:

>> I have been reading the last posts on the list, and I too don't
>> understand where you are getting. It seems you have a lot of theoretical
>> desires, but have trouble formulating your concrete wishes.
>
> I have got a mixture of theoretical "design considerations" and
> practical suggestions in mind to improve the situation.
> - Documentation update
> - Completion of abstract class libary (Example: addition of a
> compilation/translation unit interface and graph related APIs)

In general, and _especially_ in volunteer software projects, suggestions
of what other people can do to make designs better don't gain a lot of
traction until the person offering the suggestions has gained some
credibility by personally investing effort in the project that directly
leads to tangible results such as code, documentation, or tests. Apply
some "elbow grease" here and you may actually find the atmosphere
receptive to your suggestions.  Continue to offer paths paths for others
to research without having a track record of success in the
code/doc/testbase, and I'm sure your suggestions will be ignored.

Just a bit of friendly advice,

-- 
Dave Abrahams
Boost Consulting
http://boost-consulting.com