[
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