[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [ecf-dev] ECF 3.5.1 and no conference call today (4/4/2011)

On 4/5/2011 10:16 AM, Wim Jongman wrote:
Bug fixes are fine but I would like to swap devtime for doctime for this release if possible [1].

[1] http://wiki.eclipse.org/EIG:Integrators_Guide

I would be very happy if 3.5.1 consisted of just a few bug fixes, and a *lot* of additional documentation content [1]. We are not at all limited by the EF review process for documentation development, so there are absolutely no process costs associated with developing lots of new reference documentation, examples, tutorials, presentations...and even blog posts.


All forms of documentation...IMHO...are now as important to ECF as code changes (bug fixes or new features). The reason for this is that ECF now has quite a lot of functionality...including lots of great modularity-enabled features (provider architecture), lots of useful APIs, lots of providers, lots of extensibility and flexibility...but the main problem (IMHO) is that much of this flexibility (and the value that it creates) is too hidden in the minds of the ECF committers.

Fortunately...and thanks to everyone...this is changing...but we can accelerate the change through efforts on documentation and promotion...and I think that we should, as a community, work together to explicitly make ECF more open and more transparent by explaining (or demonstrating) what it can do...to a much larger audience.

Speaking for myself: although I will continue to do as much as I can in terms of documentation, examples, tutorials, blog postings, presentations, etc...a few of us cannot shoulder the entire burden for this documentation effort. We have to get more contributions and more participation...from ECF committers, from contributors, and users. This does *not* have to require a huge time commitment by anyone, and the use of the wiki, blogs, this mail list, the newsgroup, wikitext, etc...and open cross-organizational communication...makes this a much lighter weight thing than creating API/sw documentation used to be.

</speech>  (you didn't know that was coming, did you?   :)

Now...please join the ECF documentation project bug...by clicking on this link [2], and adding yourself as a cc to that bug. Then...contribute in any way you can.

Thanks,

Scott

[1] https://bugs.eclipse.org/bugs/show_bug.cgi?id=329124