To give a perspective on the references and examples part from our
organization...
When we started trying to convert one of our small apps we choose the
Jewel set of components. This was because it had lots of visible content and
examples [1] whereas the standard examples were more limited [2]. Carlos does
a good job of advertising new features with pictures, short descriptions, and
some examples. It would be nice to consolidate that information back into the
Royale site. The Tour de Jewel examples being hosted on the Royale site is a
good idea. This is why we used Jewel as our base to build our organizational
library from. There might be other component sets that are fully functional,
but without good references and examples they are basically unknown or gray
boxes.
The hosted ASDOCs on the Royale site [3] are a bit harder to read and are
missing different component sets like jewel. We were not able to use it for
finding most of the things we were looking for. Instead we used the SDK source
and searched for class names / content. Then we could walk the class file
source and their inheritance to find what we were looking for. Like hunting
for premade beads.
So if I were to order what a person might need to start (I know we have parts
of this already):
-How to download SDK binaries and get minimum requirements done.
-What IDE's are available and how to set them up.
-Starting a new app and getting it to compile for the first time.
-Good reference (ASDOCs) being more complete.
-Examples of using the components and how to use them.
-Whole example applications showing a purpose and integration of multiple
techniques.
[1] https://royale.apache.org/tourdejewel/
[2] https://royale.apache.org/category/royale-examples/
[3] https://royale.apache.org/asdoc/
-Mark K
