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

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


The following commit(s) were added to refs/heads/master by this push:
     new a8257ea  Update mxml.md
a8257ea is described below

commit a8257ea6a7cac33139705f8eb711cbb7a78e6ee4
Author: Andrew Wetmore <and...@cottage14.com>
AuthorDate: Wed Apr 22 19:40:44 2020 -0300

    Update mxml.md
    
    edit in progress
---
 features/mxml.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/features/mxml.md b/features/mxml.md
index 92df6e5..a2b31d2 100644
--- a/features/mxml.md
+++ b/features/mxml.md
@@ -24,9 +24,9 @@ permalink: /features/mxml
 
 The declarative XML-based user interface markup language
 
-MXML is an XML language that you use, when building an application in Royale, 
to lay out user-interface components.
+MXML is an XML-based language introduced in 2004 by Macromedia. In Royale you 
use it to lay out user-interface components. You can create an application in 
Royale using only [ActionScript](features/as3), but it takes a lot more work.
 
-Most Royale applications have an MXML file as the main file in the app. It 
provides the structure of the application, and generally imports resources and 
functions that the app needs.
+Most Royale applications have an MXML file as the main file in the app. It 
provides the structure of the application. A simple main MXML file might look 
like this:
 
 ```mxml
 <?xml version="1.0" encoding="utf-8"?>
@@ -53,3 +53,7 @@ Most Royale applications have an MXML file as the main file 
in the app. It provi
     </j:Card>
 </j:Group>
 ```
+
+## What goes where ##
+
+The more complex the application is, the more things the main MXML file needs 
to be able to support and do. Typically, a developer organizes the file so it 
is easy to locate things in it. Some elements must be inside certain tags, and 
for others you have a lot of flexibility. However, if you are working in a 
team, it is good to have an agreement about what goes where so nobody wastes 
time or adds in code that already exists somewhere else in the file.

Reply via email to