[mapguide-commits] r5772 - in trunk/Tools/Maestro/UserDoc: . source

Tue May 10 11:48:30 EDT 2011

Author: jng
Date: 2011-05-10 08:48:30 -0700 (Tue, 10 May 2011)
New Revision: 5772

Modified:
   trunk/Tools/Maestro/UserDoc/
   trunk/Tools/Maestro/UserDoc/source/differences.rst
   trunk/Tools/Maestro/UserDoc/source/introduction.rst
   trunk/Tools/Maestro/UserDoc/source/mapguide_terminology.rst
   trunk/Tools/Maestro/UserDoc/source/understanding_applications.rst
Log:
#1677: More content for the Maestro User Guide


Property changes on: trunk/Tools/Maestro/UserDoc
___________________________________________________________________
Added: svn:ignore
   + build


Modified: trunk/Tools/Maestro/UserDoc/source/differences.rst
===================================================================

--- trunk/Tools/Maestro/UserDoc/source/differences.rst	2011-05-10 14:54:06 UTC (rev 5771)
+++ trunk/Tools/Maestro/UserDoc/source/differences.rst	2011-05-10 15:48:30 UTC (rev 5772)
@@ -1,8 +1,33 @@
 Differences between Maestro and MapGuide Studio
 ===============================================
 
+Note: As of the 2012 release, MapGuide Enterprise is now known as Autodesk Infrastructure Map Server and the MapGuide Studio product is now called Autodesk Infrastructure Studio. This section will refer to these products by their old names.
+
+Both Maestro and MapGuide Studio fulfill the same purpose: To create, author and publish spatial data on a MapGuide Server. However there are some main differences:
+
+ * MapGuide Studio is a commerical product that comes with a MapGuide Enterprise licence only. It cannot be purchased separately.
+ * MapGuide Maestro is free and open-source. It is the only viable authoring solution for a MapGuide Open Source user. A licensed MapGuide Enterprise user has the choice of either tools when authoring.
+
+Fortunately, MapGuide Maestro is a capable alternative to MapGuide Studio. Besides the base shared features of loading/creating/publishing data, both tools have their own unique set of features, which this section will cover.
+
 Features unique to MapGuide Studio
 ----------------------------------
 
+ * MapGuide Studio supports loading of DWG files and raster images. Due to licensing and/or the need to be multi-platform, Maestro does not (and probably will never) support these features.
+ * MapGuide Studio supports creating and editing Symbol Libraries. Maestro cannot edit Symbol Libraries, however it has read support for these resources and Maestro supports symbol selection from Symbol Libraries.
+ * MapGuide Studio supports the "Convert to SDF" and generalization options of Load Procedures.
+
 Features unique to MapGuide Maestro
------------------------------------
\ No newline at end of file
+-----------------------------------
+
+ * Maestro is multi-platform. It runs on Windows, Linux and Mac OSX.
+ * Maestro can connect to many different versions of MapGuide Open Source and MapGuide Enterprise (as far back as MGOS 1.2 / MGE 2008)
+ * Maestro supports validating resources ensuring data/resource integrity and trapping common errors and pitfalls that would normally be silent under MapGuide Studio.
+ * Maestro has a small installation footprint (under 20mb) compared to MapGuide Studio.
+ * Maestro allows you to edit any resource in its XML form. The XML editor is used as a fallback measure if Maestro encounters unsupported or unrecognised resources.
+ * Maestro supports all known resource versions. Maestro will *never* silently upgrade your resources to the latest version.
+ * Maestro supports custom resource templates
+ * Maestro supports the creation and loading of MapGuide Packages (MGP) without needing to use the Site Administrator web application.
+ * Maestro has a more active development cycle.
+ * Maestro offers plenty of tools and shortcuts that greatly improves authoring productivity.
+ * and much more!
\ No newline at end of file

Modified: trunk/Tools/Maestro/UserDoc/source/introduction.rst
===================================================================
--- trunk/Tools/Maestro/UserDoc/source/introduction.rst	2011-05-10 14:54:06 UTC (rev 5771)
+++ trunk/Tools/Maestro/UserDoc/source/introduction.rst	2011-05-10 15:48:30 UTC (rev 5772)
@@ -1,2 +1,10 @@
 Introduction
-============
\ No newline at end of file
+============
+
+MapGuide Maestro is an Open Source (LGPL) map authoring tool for MapGuide Open Source and Autodesk MapGuide Enterprise / Autodesk Infrastructure Map Server.
+
+MapGuide Maestro is a free application that can ease the management of spatial data in a MapGuide Server.
+
+MapGuide Maestro is a windows application written in 100% managed C#, targeting the .Net 2.0 Framework and can run in Linux and Mac OSX with the Mono framework (http://www.mono-project.com). It consists of a user interface, and an API (Maestro API). The API wraps server communication and Xml formats, in easily accesible, fully managed classes. It can use the official MapGuide API for fast access on the local network, or a fully managed http-only connection. Other connection types are planned in future releases.
+
+MapGuide Maestro is designed with flexibility and extensibility in mind. The tool tries very hard not to take any options away, and always allows you to edit the internal Xml of the feature you are working with. This ensures that features that are missing from the interface can still be accessed.
\ No newline at end of file

Modified: trunk/Tools/Maestro/UserDoc/source/mapguide_terminology.rst
===================================================================
--- trunk/Tools/Maestro/UserDoc/source/mapguide_terminology.rst	2011-05-10 14:54:06 UTC (rev 5771)
+++ trunk/Tools/Maestro/UserDoc/source/mapguide_terminology.rst	2011-05-10 15:48:30 UTC (rev 5772)
@@ -9,8 +9,140 @@
 Types of Resources
 ------------------
 
-...
+.. todo::
+    Detail the features offered with each schema revision. Most of this already is covered in resource-readme.txt in the Maestro source code.
 
+There are many types of resources that can be stored in a MapGuide Server
+
+Feature Sources
+^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Feature Sources describe a FDO connection to a particular data store, which could be inside the MapGuide Server or stored externally. (see below: Spatial Data and Regular Data)
+
+Drawing Sources
+^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Drawing Sources are DWF data sources which provide drawing data with full visual fidelity. 
+
+Layer Definitions
+^^^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+ * 1.1.0 - MapGuide Open Source 1.2 / MapGuide Enterprise 2008
+ * 1.2.0 - MapGuide Open Source 2.0 / MapGuide Enterprise 2009
+ * 1.3.0 - MapGuide Open Source 2.1 / MapGuide Enterprise 2010
+
+Layer Definitions describe how data from a Feature Source is to be styled. (see below: Displaying Data)
+
+Map Definitions
+^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+ * 2.3.0 - MapGuide Open Source 2.3 / MapGuide Enterprise 2012
+
+Map Definitions contains one or more Layer Definitions grouped together and sorted by drawing order.
+
+Web Layouts
+^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+ * 1.1.0 - MapGuide Open Source 2.2 / MapGuide Enterprise 2011
+
+Describes the user interface for the AJAX viewer (see: Understanding MapGuide Applications - Web Layouts)
+
+Application Definitions
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 2.0 / MapGuide Enterprise 2009
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 2.0 / MapGuide Enterprise 2009
+
+Describes the user interface for the Fusion viewer (see: Understanding MapGuide Applications - Application Definitions)
+
+Load Procedures
+^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Version(s): 
+ 
+ * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+ * 1.1.0 - MapGuide Open Source 2.0 / MapGuide Enterprise 2009
+ * 2.2.0 - MapGuide Open Source 2.2 / MapGuide Enterprise 2011
+
+Describes to a client application like MapGuide Studio, how to load a set of data files into the MapGuide Server
+
+Print Layouts
+^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Describes the printing layout for a DWF plot operation
+
+Symbol Libraries
+^^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
+
+Describes a collection of DWF-based symbols that can be used for point styles in a Layer Definitions
+
+Symbol Definitions
+^^^^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 1.2 / MapGuide Enterprise 2008
+
+Version(s): 
+
+ * 1.0.0 - MapGuide Open Source 1.2 / MapGuide Enterprise 2008
+ * 1.1.0 - MapGuide Open Source 2.0 / MapGuide Enterprise 2009
+
+Describes a cartographic symbol, which has lots of display and customisation parameters. Used by Layer Definitions.
+
+Watermark Definitions
+^^^^^^^^^^^^^^^^^^^^^
+
+Introduced: MapGuide Open Source 2.3 / MapGuide Enterprise 2012
+
+Version(s): 
+
+ * 2.3.0 - MapGuide Open Source 2.3 / MapGuide Enterprise 2012
+
+Describes a watermark that is rendered as part of the map when viewing it. Used by Map Definitions.
+
 Spatial Data and Regular Data
 -----------------------------
 

Modified: trunk/Tools/Maestro/UserDoc/source/understanding_applications.rst
===================================================================
--- trunk/Tools/Maestro/UserDoc/source/understanding_applications.rst	2011-05-10 14:54:06 UTC (rev 5771)
+++ trunk/Tools/Maestro/UserDoc/source/understanding_applications.rst	2011-05-10 15:48:30 UTC (rev 5772)
@@ -1,5 +1,5 @@
-Understanding Applications
-==========================
+Understanding MapGuide Applications
+===================================
 
 Web Layouts
 -----------

