[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [ecf-dev] JavaDoc (or lack thereof)
- From: Harshana Eranga Martin <harshana05@xxxxxxxxx>
- Date: Sat, 28 May 2011 14:20:58 +0530
- Delivered-to: email@example.com
- Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :content-type; b=fGp7pJSnlIbkC4Y4hf4E20UEE0k2Aw5p9iMOshvKZW0cgjYhrSm0AJwf4/XYAo4BUe vg1ETAbaL+0C8dkr82ACQ8AA01hus1ZISCVjwVAc5+uexF5IrRwHiugULLqOrkj49uxn mjr5aWEhFsYMyIWY7F85xgCtkFoucamBN6spk=
On 27 May 2011 20:21, Scott Lewis <slewis@xxxxxxxxxxxxx>
First, thanks for the offer of contribution/help with the documentation. ÂIt's an ongoing problem that we are trying to address (with the help of the community).
Have you consulted the generated javadocs? Â http://www.eclipse.org/ecf/org.eclipse.ecf.docs/api/
Although we are aware that there are plenty of missing pieces to this and other ECF documentation. ÂECF now has a 'documentation project' where we've been trying to coordinate community contributions to address the lack of ECF documentation problem...and I think that would probably be the best way for you to coodinate your contributions as well.
Here  is a link to ECF documentation project links on the wiki. Â There's a bug listed there  that hopefully you can join and we can continue to use that to coordinate the mechanisms for various kinds of documentation contributions. ÂIf you are interested, we can examine making you an ECF committer.
WRT patches via git...this is still a problem. ÂAnyone have ideas on how to manage patches/contributions with git?
My timing might not be the perfect. But Have we considered Gerrit. For me it looks promising + EGit already has one instance running under EF .
On 5/27/2011 6:50 AM, Alex Blewitt wrote:
In working through setting up an ECF container, I noticed a serious lack of JavaDoc documentation, which hindered by ability to figure out what was going on. This, and finding out who the key actors are and how they're invoked made it more difficult than it needs to be in order to find out what's going on.
I'd like to help improve that situation by starting to create documentation for the framework and the like. I have a fork of the GitHub instance where I'm planning to do my work there - does that make the best place? We can then review any changes necessary prior to committing in as a bugzilla instance.
I'm also an Eclipse committer as well (though haven't actually committed anything directly) so don't know if that makes it easier to hook up. But hopefully it means my committer ID will allow me to have the changes absorbed as is. The whole Git attached as patches is somewhat new to me :)
ecf-dev mailing list
ecf-dev mailing list
Thanks and Regards,
Harshana Eranga Martin