Eclipse Handly 0.2 Release Review

End Date of the Review Period: 

Reviews run for a minimum of one week. The outcome of the review is decided on this date. This is the last day to make comments or ask questions about this review.

Wednesday, September 24, 2014



The primary reason for this major release is coping with breaking changes introduced in Xtext 2.7 (bug 442674). This release will coincide with Handly 0.1.1 and Eclipse Luna SR1 to minimize disruption for those adopters who use Handly Xtext integration. While Handly 0.1.1 will remain compatible with Xtext 2.5, it will not work with Xtext 2.7 or greater, whereas Handly 0.2 will be integrated with Xtext 2.7 but will not support previous Xtext versions.

Architectural Issues: 

There is no declared API in this release as both the API and the API policy may still evolve. Separation between API and internal code does exist. Documentation is improving.

Non-Code Aspects: 

We still have a fully functional PMI-based website [1], automated CBI-based build [2], an architectural overview [3], the contributor guide [4], committer FAQ [5], and a basic exemplary implementation provided in Handly Examples.

However, there is also a new artifact: we've finished drafting a step-by-step guide to getting started with Handly. It is hosted on GitHub [6] and made available under the EPL v1.0. Despite being a work in progress, we really hope that even in its current form, it will be very useful for Handly adopters. Early feedback is welcome.


All discussion happens on open channels of developer mailing list [1], adopter forum [2] and bugzilla [3]. The project lead's blog posts on topics surrounding Handly [4] are syndicated to Planet Eclipse.

Still looking for community feedback and an initial adopter at Eclipse.

It seems that there is some interest from the LDT project in considering Handly for adoption [5]. FWIW, there is also a steady increase in views of the Handly proposal's topic (from 1,000+ before Handly 0.1 release to 10,000+ at the moment) [6]. As mentioned above, we have authored a complete guide to getting started with Handly that hopefully will help adoption [7]. Also, we have enabled Gerrit code review for Handly [8] to streamline the contribution process.