org.eclipse.handly.examples.basic/README

Basic Example
=============

Please see the `README` file in the `org.eclipse.handly.examples` bundle 
for general information regarding Handly Examples.

The basic example (`o.e.handly.examples.basic*`) demonstrates a full-featured 
Handly-based model for a simple Xtext-based language, complete with automated 
tests, content outline, and a CNF-based navigator view.

Launch runtime Eclipse (you can use the predefined launch configuration) and 
open the Resource perspective, then create a new project using the 
`Foo Project` wizard. (The wizard is in the `Foo` category.)

Create a new file in the root of the project you've just created; the filename 
must have the `.foo` extension. For example, create the `Module1.foo` file 
with the following contents:

var x;
var y;
def f() {}
def f(x) {}
def f(x, y) {}

Play with the Handly-based Outline view a little.

Open the `Foo Navigator` view (under the `Foo` category) and give it a try. 
Don't forget to expand Foo source files to see their inner elements, 
and try out the `Link with Editor` functionality. Edit a Foo file and 
see how changes in its inner structure are reflected in the Foo Navigator 
alongside the Outline view. (The navigator view is based on CNF and Handly.)

Now you might want to study the implementation. It is probably a good idea 
to begin with `o.e.handly.examples.basic.ui.tests` (that can be run with 
the same-named predefined launch configuration) and work from there toward 
`o.e.handly.examples.basic.ui`.