0.5 release notes

Author: UnquietCode

VERSION.txt

@@ -1,8 +1,47 @@
+# Version 0.5
+Flapi Version 0.5 has been released! Here are the highlights.
+
+### Grouped any() Methods
+Methods in a descriptor marked as `any()` can now be associated with a group via the `any(int group)` method. This, combined with `atMost(..)`, comprises what is known as [Method Grouping](Method-Grouping-and-Triggering)
+
+### Flapi's builder is no longer in source control!
+The generated source code used by the main descriptor builder is no longer part of the codebase. Instead, it is generated at build time using the maven plugin made available starting with version 0.4. The plugin makes it easier to keep generated code out of your source repositories, and now Flapi itself can reap the benefit. 
+
+### New Flapi User Group on Google
+A user group for Flapi has been created on Google Groups. Feel free to ask questions, leave comments, and otherwise interact with other people using the tool. [Check it out!](https://groups.google.com/forum/#!forum/flapi-users)
+
+### BREAKING CHANGE - wrapper interface is now 'Start'
+Previously, the wrapper interface was called `$`. Flapi 0.5 has removed all uses of the '$' character from the generated classes to address [Flapi-159](https://unquietcode.atlassian.net/browse/FLAPI-159). The wrapper has been changed to the `*Builder.Start` interface generated for each block. While an inconvenience for those making use of the old interface, this flows from the tool's mandate to be compatible with the most number of code editors.
+
+## Resolved Issues
+
+### Improvement
+    + [FLAPI-92] - Allows the top level descriptor block to be used recursively.
+    + [FLAPI-118] - Support method grouping for any() methods.
+    + [FLAPI-156] - Make it possible to declare return types by String instead of by Class, allowing looser coupling.
+    + [FLAPI-158] - Remove Flapi builder from source control, use plugin instead.
+    + [FLAPI-159] - Remove dollar sign from names, as it has spotty support from tooling.
+    + [FLAPI-166] - Detect and reject infinite loops when possible.
+    + [FLAPI-171] - Support for grouped atLeast methods.
+    + [FLAPI-179] - Support array types throughout.
+
+### Task
+    + [FLAPI-121] - Moves example tests into a single test suite.
+    + [FLAPI-122] - Removing license from Flapi.
+    + [FLAPI-160] - Document wrapper interface in wiki.
+    + [FLAPI-161] - Document ExecutionListener interface in wiki.
+    + [FLAPI-168] - Document helpers in wiki.
+    + [FLAPI-173] - Document method grouping / triggering in wiki.
+    + [FLAPI-182] - Create a mailing list / user group for Flapi.
+
+The full list of tasks and issues included in the release is available on the project's [JIRA](https://unquietcode.atlassian.net/secure/ReleaseNote.jspa?projectId=10160&version=10740).
+
+------------------------------------------------
+
 # Version 0.4
 Flapi 0.4 includes several bugfixes, as well as a bunch of new features. This release is larger than the
 rest, and has been a long time coming.
 
-
 ### No more *Impl classes!
 The biggest change is moving from the generated implementation classes to a single JDK proxy. This means
 that only the interfaces need to be generated for your API. A single, shared runtime is provided, and
@@ -173,4 +212,4 @@ This version includes a few notable changes:
 Notes also available at: https://github.com/UnquietCode/Flapi/wiki/v0_1
 JIRA: https://unquietcode.atlassian.net/secure/ReleaseNote.jspa?projectId=10160&version=10140
 
-Initial beta release.
+Initial beta release.