[02/12] docs commit: [CB-3820] add CLI to config.xml discussion

[mw...@apache.org]

[CB-3820] add CLI to config.xml discussion


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/8a37ba32
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/8a37ba32
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/8a37ba32

Branch: refs/heads/master
Commit: 8a37ba325be2f61b7ed9961ba9e26ef30362474c
Parents: e73f0d5
Author: Mike Sierra <le...@gmail.com>
Authored: Fri Jul 19 13:41:49 2013 -0400
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Wed Jul 24 15:10:08 2013 -0700

----------------------------------------------------------------------
 docs/en/edge/config_ref/index.md | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/8a37ba32/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 807f13f..e060740 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -19,16 +19,22 @@ license: Licensed to the Apache Software Foundation (ASF) under one
 
 # Configuration Reference
 
-You can set various application configuration parameters using a platform-agnostic configuration file, `config.xml`.
-This file is based on the W3C [Packaged Web Apps (Widgets)](http://www.w3.org/TR/widgets/) specification.
-
-The location of the `config.xml` file is different depending on the platform. The contents, in general, are not.
-
-## Platform-Specific Properties
-
-As with any abstraction layer, Apache Cordova cannot be a perfect silver bullet. As such, some native and platform-specific
-properties, characteristics and behaviours are encapsulated as much as possible as `<preference>` elements inside the
-`config.xml` file. The following sub-sections linked to are guides which go into more details about these preferences.
+Many aspects of an application's behavior can be controlled with a
+platform-agnostic configuration file, `config.xml`, which is formatted
+based on the W3C's
+[Packaged Web Apps (Widgets)](http://www.w3.org/TR/widgets/)
+specification.
+
+For projects created with the Cordova CLI (described in The
+Command-line Interface), this file can be found in the top-level `www`
+directory.  Using the CLI to build projects regenerates versions of
+this file in various subdirectories within `platforms`. For non-CLI
+projects, each platform-specific file serves as a source.
+
+While the location of the `config.xml` file may change depending on
+the platform, its contents generally do not. Some platform-specific
+features are also specified in the same configuration file. Details
+are listed below:
 
 - iOS Configuration
 - Android Configuration