[royale-docs] branch develop updated: Update migrate-from-js.md

[an...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

andreww pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/royale-docs.git


The following commit(s) were added to refs/heads/develop by this push:
     new c7c7e8b  Update migrate-from-js.md
c7c7e8b is described below

commit c7c7e8b23038e3d47925ead08be0117031cdf2e2
Author: Andrew Wetmore <an...@cottage14.com>
AuthorDate: Fri Jan 26 11:55:10 2018 -0400

    Update migrate-from-js.md
---
 .../migrate-an-existing-app/migrate-from-js.md      | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/create-an-application/migrate-an-existing-app/migrate-from-js.md b/create-an-application/migrate-an-existing-app/migrate-from-js.md
index 6928794..6f4abd1 100644
--- a/create-an-application/migrate-an-existing-app/migrate-from-js.md
+++ b/create-an-application/migrate-an-existing-app/migrate-from-js.md
@@ -18,6 +18,25 @@ layout: docpage
 title: Migrate from JavaScript
 ---
 
+<!-- Based on material written for FlexJS by Peter Ent and modified by Tom Chiverton -->
+
 # Migrate from JavaScript
 
-*This information will be available soon.*
+JavaScript (JS) is a pervasive scripting language, used for everything from small animations in websites to fully-functioning applications. It is one of the three core languages of the World Wide Web, along with HTML and Cascading Style Sheets (CSS). All modern browsers, on computers and mobile devices, deploy JS by default.
+
+Developing an application in JS generally means creating components that do specific things and then attaching components to each other via code you write. However, JS is a loosely-typed language, so you can literally attach anything to anything, sometimes with unfortunate results. You can assign a String to a variable that was expecting an integer, and the code will have a tough time proceeding. 
+
+JS has some 'compilers' that try to catch problems before the app user crashes into them, but once you start using Objects or low-level base classes like EventDispatcher, you can easily cause the compiler to lose track of the actual API parameters involved and not find out until too late. Often JS developers make use of libraries of functions developed and shared by other developers, often only loading that codea at runtime. JS verifiers have trouble keeping up when there is a problem in [...]
+
+Most of us are familiar with furniture, toys, and other comsumables that have "some assembly required". That is true of all software languages, but some provide better guidance than others. JS offers lots of options for writing your code and sticking it together, but unless you are very attentive or very experienced, you can end up with a package has a mysterious glitch somewhere inside it that it is hard to track down and fix.
+
+Royale is also an assemble-it-yourself language. However, like the better furniture stores that provide not just the nails and screws but instructions with illustrations, Royale helps you develop in a way that minimizes errors. Semi-Structured languages like ActionScript let you establish custom connectors so that the components you write can only go together in certain ways.  Declarative languages like MXML provide diagrams to help you see the pieces that you are attaching and what you  [...]
+
+Many in the JS world use higher-level languages like Dart and TypeScript to reduce the chances of error in the JS code they write. Royale provides similar guardrails; it also provdes the option to use a declarative language, MXML.
+
+If you are thinking of moving to an easier way of writing applications, compiling them into JavaScript and releasing them to the world on a wide range of platforms, Royale may be your answer.
+
+Take Royale out for a spin!
+
+- Hello, world!
+- [Create an applicaton](Create%20An%20Application.html)

-- 
To stop receiving notification emails like this one, please contact
andreww@apache.org.