cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblot...@apache.org
Subject [2/2] docs commit: Added instructions for adding redirects.
Date Sat, 13 Feb 2016 01:06:15 GMT
Added instructions for adding redirects.


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

Branch: refs/heads/master
Commit: ba6c2613afda70f66edc318fa4b3c22bb3daf5f8
Parents: 64ebddf
Author: Dmitry Blotsky <dmitry.blotsky@gmail.com>
Authored: Mon Feb 8 21:45:03 2016 -0800
Committer: Dmitry Blotsky <dmitry.blotsky@gmail.com>
Committed: Fri Feb 12 02:36:34 2016 -0800

----------------------------------------------------------------------
 README.md                    |  53 ++++++++++++
 www/.htaccess                |  25 ++++--
 www/_data/docs-redirects.yml | 157 -----------------------------------
 www/_data/redirects.yml      | 168 ++++++++++++++++++++++++++++++++++++++
 www/docs/en/deprecated.md    |  23 ++++++
 5 files changed, 260 insertions(+), 166 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba6c2613/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 72dac76..6bb2d6c 100644
--- a/README.md
+++ b/README.md
@@ -131,6 +131,58 @@ Alternatively, to dynamically rebuild the site and refresh the browser
_when cha
 
     node_modules/.bin/gulp watch
 
+## Redirects
+
+Sometimes docs pages get removed, renamed, and added. There is [a file][redirects] that contains
redirects for such occasions. It has three sections:
+
+- `docs-global`: redirects across all docs versions and languages,
+- `docs`: version-specific docs redirects, and
+- `general`: single-page redirects.
+
+For non-docs URIs, there are no versioning considerations. Make redirects like so:
+
+    general:
+        - {old: "old/uri/for/page.html", new: "its/new/uri.html"}
+
+**NOTE**: Review (and test, if possible) these redirects before making them live, since they're
permanent (HTTP 302) redirects. Incorrect permanent redirects will make a URI very hard to
bring back into browsers and search indices.
+
+There are five cases of changing URIs:
+
+1. Adding a brand new (no past equivalent) URI starting at a version,
+2. Removing an old URI (with no replacement) starting at a version,
+3. Renaming (removing and adding) an existing URI starting at a version,
+4. Renaming an existing URI across all versions,
+5. Removing an existing URI across all versions.
+
+### Case 1: Adding a URI starting at a version
+
+Do nothing. Going back in time for new docs is unsupported.
+
+### Cases 2 &amp; 3: Removing or renaming a URI starting at a version
+
+If the URI is removed, mark it as deprecated in `latest/` like so:
+
+    docs:
+        - {old: "latest/old/uri/for/page.html", new: "deprecated.html"}
+
+If the URI is moved, point it to its new location in `latest/` like so:
+
+    docs:
+        - {old: "latest/old/uri/for/page.html", new: "latest/its/new/uri.html"}
+
+These will handle the case where the "this content is outdated" link is clicked. The case
where a user jumps to a specific version is not yet supported.
+
+### Case 4: Renaming a URI across all versions
+
+Add the redirect (in the `docs-global` section this time) like so:
+
+    docs-global:
+        - {old: "old/uri/for/page.html", new: "its/new/uri.html"}
+
+### Case 5: Removing a URI across all versions
+
+Do nothing. It is now an un-URI. It never existed. Mentioning it is thoughtcrime.
+
 Deploying
 =========
 
@@ -329,3 +381,4 @@ Please ask for help on the Slack channel. Join at [slack.cordova.io](http://slac
 [python_installer_mac]: https://www.python.org/ftp/python/2.7.11/python-2.7.11-macosx10.6.pkg
 [python_installer_windows]: https://www.python.org/ftp/python/2.7.11/python-2.7.11.amd64.msi
 [python_linux]: http://docs.python-guide.org/en/latest/starting/install/linux/
+[redirects]: www/_docs/redirects.yml

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba6c2613/www/.htaccess
----------------------------------------------------------------------
diff --git a/www/.htaccess b/www/.htaccess
index 8d5d8f8..4965bca 100644
--- a/www/.htaccess
+++ b/www/.htaccess
@@ -48,15 +48,22 @@ RewriteRule ^.*docs/(\w\w)/edge$ {{site.baseurl}}/docs/$1/edge/
 RewriteRule ^.*docs/(\w\w)/edge/(.*)$ {{site.baseurl}}/docs/$1/dev/$2 [R=301,L]
 
 # 301 (perm):
-#       old docs pages -> new docs pages (from www/_data/docs-redirects.yml)
+#       old docs pages -> new docs pages (global)
 #
 # NOTE:
-#       The first part of the path (i.e. the ".*") is
-#       thrown away and replaced by site.baseurl.
-# NOTE:
-#       The reason for this not just being "redirects" and rather being
-#       docs-specific is: these redirects happen for every version of the
-#       docs. That's 157 redirects * 84 versions ~= 13000 redirects! Doing
-#       special pattern-matching for docs keeps that number at _only_ 157.
-{% for redirect in site.data.docs-redirects %}RewriteRule ^.*docs/(\w\w)/([^/]+)/{{redirect.old}}$
{{site.baseurl}}/docs/$1/$2/{{redirect.new}} [R=301,L]
+#       The first part of the path (i.e. the ".*") is thrown away and replaced
+#       by site.baseurl. It is thrown away because there is no RewriteCond to
+#       control whether the rewrite happens to a URI or a local file path
+#       (when Apache is locating the local file to serve).
+{% for redirect in site.data.redirects.docs-global %}RewriteRule ^.*docs/(\w\w)/([^/]+)/{{redirect.old}}$
{{site.baseurl}}/docs/$1/$2/{{redirect.new}} [R=301,L]
+{% endfor %}
+
+# 301 (perm):
+#       old docs pages -> new docs pages (version-specific)
+{% for redirect in site.data.redirects.docs %}RewriteRule ^.*docs/(\w\w)/{{redirect.old}}$
{{site.baseurl}}/docs/$1/{{redirect.new}} [R=301,L]
+{% endfor %}
+
+# 301 (perm):
+#       old pages -> new pages
+{% for redirect in site.data.redirects.general %}RewriteRule ^.*/{{redirect.old}}$ {{site.baseurl}}/{{redirect.new}}
[R=301,L]
 {% endfor %}

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba6c2613/www/_data/docs-redirects.yml
----------------------------------------------------------------------
diff --git a/www/_data/docs-redirects.yml b/www/_data/docs-redirects.yml
deleted file mode 100644
index bf4ec15..0000000
--- a/www/_data/docs-redirects.yml
+++ /dev/null
@@ -1,157 +0,0 @@
-- {old: "config_ref_images.md.html", new: "config_ref/images.html"}
-- {old: "config_ref_index.md.html", new: "config_ref/index.html"}
-- {old: "cordova_accelerometer_accelerometer.md.html", new: "cordova/accelerometer/accelerometer.html"}
-- {old: "cordova_camera_camera.cleanup.md.html", new: "cordova/camera/camera.cleanup.html"}
-- {old: "cordova_camera_camera.md.html", new: "cordova/camera/camera.html"}
-- {old: "cordova_compass_compass.md.html", new: "cordova/compass/compass.html"}
-- {old: "cordova_connection_connection.md.html", new: "cordova/connection/connection.html"}
-- {old: "cordova_contacts_contacts.md.html", new: "cordova/contacts/contacts.html"}
-- {old: "cordova_device_device.md.html", new: "cordova/device/device.html"}
-- {old: "cordova_device_device.model.md.html", new: "cordova/device/device.model.html"}
-- {old: "cordova_events_events.md.html", new: "cordova/events/events.html"}
-- {old: "cordova_file_file.md.html", new: "cordova/file/file.html"}
-- {old: "cordova_geolocation_geolocation.md.html", new: "cordova/geolocation/geolocation.html"}
-- {old: "cordova_globalization_globalization.md.html", new: "cordova/globalization/globalization.html"}
-- {old: "cordova_inappbrowser_inappbrowser.md.html", new: "cordova/inappbrowser/inappbrowser.html"}
-- {old: "cordova_media_capture_capture.md.html", new: "cordova/media/capture/capture.html"}
-- {old: "cordova_media_media.md.html", new: "cordova/media/media.html"}
-- {old: "cordova_notification_notification.md.html", new: "cordova/notification/notification.html"}
-- {old: "cordova_splashscreen_splashscreen.md.html", new: "cordova/splashscreen/splashscreen.html"}
-- {old: "cordova_storage_storage.md.html", new: "cordova/storage/storage.html"}
-- {old: "guide_appdev_privacy_index.md.html", new: "guide/appdev/privacy/index.html"}
-- {old: "guide_appdev_whitelist_index.md.html", new: "guide/appdev/whitelist/index.html"}
-- {old: "guide_cli_index.md.html", new: "guide/cli/index.html"}
-- {old: "guide_hybrid_plugins_index.md.html", new: "guide/hybrid/plugins/index.html"}
-- {old: "guide_hybrid_webviews_index.md.html", new: "guide/hybrid/webviews/index.html"}
-- {old: "guide_overview_index.md.html", new: "guide/overview/index.html"}
-- {old: "guide_platforms_android_config.md.html", new: "guide/platforms/android/config.html"}
-- {old: "guide_platforms_android_index.md.html", new: "guide/platforms/android/index.html"}
-- {old: "guide_platforms_android_plugin.md.html", new: "guide/platforms/android/plugin.html"}
-- {old: "guide_platforms_android_tools.md.html", new: "guide/platforms/android/tools.html"}
-- {old: "guide_platforms_android_upgrading.md.html", new: "guide/platforms/android/upgrading.html"}
-- {old: "guide_platforms_android_webview.md.html", new: "guide/platforms/android/webview.html"}
-- {old: "guide_platforms_blackberry10_config.md.html", new: "guide/platforms/blackberry10/config.html"}
-- {old: "guide_platforms_blackberry10_index.md.html", new: "guide/platforms/blackberry10/index.html"}
-- {old: "guide_platforms_blackberry10_plugin.md.html", new: "guide/platforms/blackberry10/plugin.html"}
-- {old: "guide_platforms_blackberry10_tools.md.html", new: "guide/platforms/blackberry10/tools.html"}
-- {old: "guide_platforms_blackberry10_upgrading.md.html", new: "guide/platforms/blackberry10/upgrading.html"}
-- {old: "guide_platforms_blackberry_config.md.html", new: "guide/platforms/blackberry/config.html"}
-- {old: "guide_platforms_blackberry_index.md.html", new: "guide/platforms/blackberry/index.html"}
-- {old: "guide_platforms_blackberry_plugin.md.html", new: "guide/platforms/blackberry/plugin.html"}
-- {old: "guide_platforms_blackberry_tools.md.html", new: "guide/platforms/blackberry/tools.html"}
-- {old: "guide_platforms_blackberry_upgrading.md.html", new: "guide/platforms/blackberry/upgrading.html"}
-- {old: "guide_platforms_firefoxos_config.md.html", new: "guide/platforms/firefoxos/config.html"}
-- {old: "guide_platforms_index.md.html", new: "guide/platforms/index.html"}
-- {old: "guide_platforms_ios_config.md.html", new: "guide/platforms/ios/config.html"}
-- {old: "guide_platforms_ios_index.md.html", new: "guide/platforms/ios/index.html"}
-- {old: "guide_platforms_ios_plugin.md.html", new: "guide/platforms/ios/plugin.html"}
-- {old: "guide_platforms_ios_tools.md.html", new: "guide/platforms/ios/tools.html"}
-- {old: "guide_platforms_ios_upgrading.md.html", new: "guide/platforms/ios/upgrading.html"}
-- {old: "guide_platforms_ios_webview.md.html", new: "guide/platforms/ios/webview.html"}
-- {old: "guide_platforms_tizen_index.md.html", new: "guide/platforms/tizen/index.html"}
-- {old: "guide_platforms_win8_index.md.html", new: "guide/platforms/win8/index.html"}
-- {old: "guide_platforms_win8_tools.md.html", new: "guide/platforms/win8/tools.html"}
-- {old: "guide_platforms_win8_upgrading.md.html", new: "guide/platforms/win8/upgrading.html"}
-- {old: "guide_platforms_wp7_index.md.html", new: "guide/platforms/wp7/index.html"}
-- {old: "guide_platforms_wp8_index.md.html", new: "guide/platforms/wp8/index.html"}
-- {old: "guide_platforms_wp8_plugin.md.html", new: "guide/platforms/wp8/plugin.html"}
-- {old: "guide_platforms_wp8_tools.md.html", new: "guide/platforms/wp8/tools.html"}
-- {old: "guide_platforms_wp8_upgrading.md.html", new: "guide/platforms/wp8/upgrading.html"}
-- {old: "plugin_ref_plugman.md.html", new: "plugin_ref/plugman.html"}
-- {old: "plugin_ref_spec.md.html", new: "plugin_ref/spec.html"}
-- {old: "cordova_plugins_pluginapis.md.html", new: "cordova/plugins/pluginapis.html"}
-- {old: "cordova_storage_database_database.md.html", new: "cordova/storage/database/database.html"}
-- {old: "cordova_storage_localstorage_localstorage.md.html", new: "cordova/storage/localstorage/localstorage.html"}
-- {old: "cordova_storage_parameters_display_name.md.html", new: "cordova/storage/parameters/display_name.html"}
-- {old: "cordova_storage_parameters_name.md.html", new: "cordova/storage/parameters/name.html"}
-- {old: "cordova_storage_parameters_size.md.html", new: "cordova/storage/parameters/size.html"}
-- {old: "cordova_storage_parameters_version.md.html", new: "cordova/storage/parameters/version.html"}
-- {old: "cordova_storage_sqlerror_sqlerror.md.html", new: "cordova/storage/sqlerror/sqlerror.html"}
-- {old: "cordova_storage_sqlresultset_sqlresultset.md.html", new: "cordova/storage/sqlresultset/sqlresultset.html"}
-- {old: "cordova_storage_sqlresultsetrowlist_sqlresultsetrowlist.md.html", new: "cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.html"}
-- {old: "cordova_storage_sqltransaction_sqltransaction.md.html", new: "cordova/storage/sqltransaction/sqltransaction.html"}
-- {old: "cordova_storage_storage.opendatabase.md.html", new: "cordova/storage/storage.opendatabase.html"}
-- {old: "guide_platforms_amazonfireos_config.md.html", new: "guide/platforms/amazonfireos/config.html"}
-- {old: "guide_platforms_amazonfireos_index.md.html", new: "guide/platforms/amazonfireos/index.html"}
-- {old: "guide_platforms_amazonfireos_plugin.md.html", new: "guide/platforms/amazonfireos/plugin.html"}
-- {old: "guide_platforms_amazonfireos_webview.md.html", new: "guide/platforms/amazonfireos/webview.html"}
-- {old: "guide_platforms_ubuntu_index.md.html", new: "guide/platforms/ubuntu/index.html"}
-- {old: "guide_support_index.md.html", new: "guide/support/index.html"}
-- {old: "guide_appdev_hooks_index.md.html", new: "guide/appdev/hooks/index.html"}
-- {old: "guide_appdev_security_index.md.html", new: "guide/appdev/security/index.html"}
-- {old: "guide_next_index.md.html", new: "guide/next/index.html"}
-- {old: "guide_platforms_android_upgrade.md.html", new: "guide/platforms/android/upgrade.html"}
-- {old: "guide_platforms_blackberry10_upgrade.md.html", new: "guide/platforms/blackberry10/upgrade.html"}
-- {old: "guide_platforms_blackberry_upgrade.md.html", new: "guide/platforms/blackberry/upgrade.html"}
-- {old: "guide_platforms_firefoxos_index.md.html", new: "guide/platforms/firefoxos/index.html"}
-- {old: "guide_platforms_ios_upgrade.md.html", new: "guide/platforms/ios/upgrade.html"}
-- {old: "guide_platforms_win8_packaging.md.html", new: "guide/platforms/win8/packaging.html"}
-- {old: "guide_platforms_win8_plugin.md.html", new: "guide/platforms/win8/plugin.html"}
-- {old: "guide_platforms_win8_upgrade.md.html", new: "guide/platforms/win8/upgrade.html"}
-- {old: "guide_platforms_win8_win10-support.md.html", new: "guide/platforms/win8/win10-support.html"}
-- {old: "guide_platforms_wp8_parallels.md.html", new: "guide/platforms/wp8/parallels.html"}
-- {old: "guide_platforms_wp8_upgrade.md.html", new: "guide/platforms/wp8/upgrade.html"}
-- {old: "guide_platforms_wp8_vmware.md.html", new: "guide/platforms/wp8/vmware.html"}
-- {old: "guide_platforms_wp8_webview.md.html", new: "guide/platforms/wp8/webview.html"}
-- {old: "platform_plugin_versioning_ref_index.md.html", new: "platform_plugin_versioning_ref/index.html"}
-- {old: "guide_getting-started_android_index.md.html", new: "guide/getting-started/android/index.html"}
-- {old: "guide_getting-started_blackberry_index.md.html", new: "guide/getting-started/blackberry/index.html"}
-- {old: "guide_getting-started_index.md.html", new: "guide/getting-started/index.html"}
-- {old: "guide_getting-started_ios_index.md.html", new: "guide/getting-started/ios/index.html"}
-- {old: "guide_getting-started_symbian_index.md.html", new: "guide/getting-started/symbian/index.html"}
-- {old: "guide_getting-started_webos_index.md.html", new: "guide/getting-started/webos/index.html"}
-- {old: "guide_getting-started_windows-phone_index.md.html", new: "guide/getting-started/windows-phone/index.html"}
-- {old: "guide_upgrading_blackberry_index.md.html", new: "guide/upgrading/blackberry/index.html"}
-- {old: "guide_upgrading_webos_index.md.html", new: "guide/upgrading/webos/index.html"}
-- {old: "phonegap_accelerometer_accelerometer.md.html", new: "phonegap/accelerometer/accelerometer.html"}
-- {old: "phonegap_camera_camera.md.html", new: "phonegap/camera/camera.html"}
-- {old: "phonegap_compass_compass.md.html", new: "phonegap/compass/compass.html"}
-- {old: "phonegap_connection_connection.md.html", new: "phonegap/connection/connection.html"}
-- {old: "phonegap_contacts_contacts.md.html", new: "phonegap/contacts/contacts.html"}
-- {old: "phonegap_device_device.md.html", new: "phonegap/device/device.html"}
-- {old: "phonegap_events_events.md.html", new: "phonegap/events/events.html"}
-- {old: "phonegap_file_file.md.html", new: "phonegap/file/file.html"}
-- {old: "phonegap_geolocation_geolocation.md.html", new: "phonegap/geolocation/geolocation.html"}
-- {old: "phonegap_media_capture_capture.md.html", new: "phonegap/media/capture/capture.html"}
-- {old: "phonegap_media_media.md.html", new: "phonegap/media/media.html"}
-- {old: "phonegap_notification_notification.md.html", new: "phonegap/notification/notification.html"}
-- {old: "phonegap_storage_storage.md.html", new: "phonegap/storage/storage.html"}
-- {old: "guide_getting-started_bada_index.md.html", new: "guide/getting-started/bada/index.html"}
-- {old: "guide_upgrading_android_index.md.html", new: "guide/upgrading/android/index.html"}
-- {old: "guide_upgrading_bada_index.md.html", new: "guide/upgrading/bada/index.html"}
-- {old: "guide_upgrading_index.md.html", new: "guide/upgrading/index.html"}
-- {old: "guide_upgrading_ios_index.md.html", new: "guide/upgrading/ios/index.html"}
-- {old: "guide_upgrading_symbian_index.md.html", new: "guide/upgrading/symbian/index.html"}
-- {old: "guide_upgrading_windows-phone_index.md.html", new: "guide/upgrading/windows-phone/index.html"}
-- {old: "guide_whitelist_index.md.html", new: "guide/whitelist/index.html"}
-- {old: "guide_command-line_index.md.html", new: "guide/command-line/index.html"}
-- {old: "guide_cordova-webview_android.md.html", new: "guide/cordova-webview/android.html"}
-- {old: "guide_cordova-webview_index.md.html", new: "guide/cordova-webview/index.html"}
-- {old: "guide_cordova-webview_ios.md.html", new: "guide/cordova-webview/ios.html"}
-- {old: "guide_plugin-development_android_index.md.html", new: "guide/plugin-development/android/index.html"}
-- {old: "guide_plugin-development_bada_index.md.html", new: "guide/plugin-development/bada/index.html"}
-- {old: "guide_plugin-development_blackberry_index.md.html", new: "guide/plugin-development/blackberry/index.html"}
-- {old: "guide_plugin-development_index.md.html", new: "guide/plugin-development/index.html"}
-- {old: "guide_plugin-development_ios_index.md.html", new: "guide/plugin-development/ios/index.html"}
-- {old: "guide_plugin-development_webos_index.md.html", new: "guide/plugin-development/webos/index.html"}
-- {old: "guide_plugin-development_windows-phone_index.md.html", new: "guide/plugin-development/windows-phone/index.html"}
-- {old: "guide_getting-started_tizen_index.md.html", new: "guide/getting-started/tizen/index.html"}
-- {old: "guide_plugin-development_tizen_index.md.html", new: "guide/plugin-development/tizen/index.html"}
-- {old: "guide_upgrading_tizen_index.md.html", new: "guide/upgrading/tizen/index.html"}
-- {old: "guide_getting-started_windows-8_index.md.html", new: "guide/getting-started/windows-8/index.html"}
-- {old: "guide_project-settings_index.md.html", new: "guide/project-settings/index.html"}
-- {old: "guide_project-settings_ios_index.md.html", new: "guide/project-settings/ios/index.html"}
-- {old: "guide_getting-started_windows-phone-7_index.md.html", new: "guide/getting-started/windows-phone-7/index.html"}
-- {old: "guide_getting-started_windows-phone-8_index.md.html", new: "guide/getting-started/windows-phone-8/index.html"}
-- {old: "guide_project-settings_android_index.md.html", new: "guide/project-settings/android/index.html"}
-- {old: "guide_project-settings_bada_index.md.html", new: "guide/project-settings/bada/index.html"}
-- {old: "guide_project-settings_blackberry_index.md.html", new: "guide/project-settings/blackberry/index.html"}
-- {old: "guide_project-settings_firefoxos_index.md.html", new: "guide/project-settings/firefoxos/index.html"}
-- {old: "guide_project-settings_webos_index.md.html", new: "guide/project-settings/webos/index.html"}
-- {old: "guide_project-settings_windows8_index.md.html", new: "guide/project-settings/windows8/index.html"}
-- {old: "guide_project-settings_wp7_index.md.html", new: "guide/project-settings/wp7/index.html"}
-- {old: "guide_project-settings_wp8_index.md.html", new: "guide/project-settings/wp8/index.html"}
-- {old: "guide_getting-started_blackberry10_index.md.html", new: "guide/getting-started/blackberry10/index.html"}
-- {old: "guide_plugin-development_blackberry10_index.md.html", new: "guide/plugin-development/blackberry10/index.html"}
-- {old: "guide_privacy_index.md.html", new: "guide/privacy/index.html"}
-- {old: "guide_upgrading_windows-8_index.md.html", new: "guide/upgrading/windows-8/index.html"}

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba6c2613/www/_data/redirects.yml
----------------------------------------------------------------------
diff --git a/www/_data/redirects.yml b/www/_data/redirects.yml
new file mode 100644
index 0000000..c071bbf
--- /dev/null
+++ b/www/_data/redirects.yml
@@ -0,0 +1,168 @@
+# WARNING:
+#         these are *string-only* redirects; regexes will NOT work
+
+# redirects paths relative to /
+general:
+
+# redirects paths relative to /docs/XX/
+docs:
+
+# redirects paths relative to /docs/XX/YYY/
+docs-global:
+    - {old: "config_ref_images.md.html", new: "config_ref/images.html"}
+    - {old: "config_ref_index.md.html", new: "config_ref/index.html"}
+    - {old: "cordova_accelerometer_accelerometer.md.html", new: "cordova/accelerometer/accelerometer.html"}
+    - {old: "cordova_camera_camera.cleanup.md.html", new: "cordova/camera/camera.cleanup.html"}
+    - {old: "cordova_camera_camera.md.html", new: "cordova/camera/camera.html"}
+    - {old: "cordova_compass_compass.md.html", new: "cordova/compass/compass.html"}
+    - {old: "cordova_connection_connection.md.html", new: "cordova/connection/connection.html"}
+    - {old: "cordova_contacts_contacts.md.html", new: "cordova/contacts/contacts.html"}
+    - {old: "cordova_device_device.md.html", new: "cordova/device/device.html"}
+    - {old: "cordova_device_device.model.md.html", new: "cordova/device/device.model.html"}
+    - {old: "cordova_events_events.md.html", new: "cordova/events/events.html"}
+    - {old: "cordova_file_file.md.html", new: "cordova/file/file.html"}
+    - {old: "cordova_geolocation_geolocation.md.html", new: "cordova/geolocation/geolocation.html"}
+    - {old: "cordova_globalization_globalization.md.html", new: "cordova/globalization/globalization.html"}
+    - {old: "cordova_inappbrowser_inappbrowser.md.html", new: "cordova/inappbrowser/inappbrowser.html"}
+    - {old: "cordova_media_capture_capture.md.html", new: "cordova/media/capture/capture.html"}
+    - {old: "cordova_media_media.md.html", new: "cordova/media/media.html"}
+    - {old: "cordova_notification_notification.md.html", new: "cordova/notification/notification.html"}
+    - {old: "cordova_splashscreen_splashscreen.md.html", new: "cordova/splashscreen/splashscreen.html"}
+    - {old: "cordova_storage_storage.md.html", new: "cordova/storage/storage.html"}
+    - {old: "guide_appdev_privacy_index.md.html", new: "guide/appdev/privacy/index.html"}
+    - {old: "guide_appdev_whitelist_index.md.html", new: "guide/appdev/whitelist/index.html"}
+    - {old: "guide_cli_index.md.html", new: "guide/cli/index.html"}
+    - {old: "guide_hybrid_plugins_index.md.html", new: "guide/hybrid/plugins/index.html"}
+    - {old: "guide_hybrid_webviews_index.md.html", new: "guide/hybrid/webviews/index.html"}
+    - {old: "guide_overview_index.md.html", new: "guide/overview/index.html"}
+    - {old: "guide_platforms_android_config.md.html", new: "guide/platforms/android/config.html"}
+    - {old: "guide_platforms_android_index.md.html", new: "guide/platforms/android/index.html"}
+    - {old: "guide_platforms_android_plugin.md.html", new: "guide/platforms/android/plugin.html"}
+    - {old: "guide_platforms_android_tools.md.html", new: "guide/platforms/android/tools.html"}
+    - {old: "guide_platforms_android_upgrading.md.html", new: "guide/platforms/android/upgrading.html"}
+    - {old: "guide_platforms_android_webview.md.html", new: "guide/platforms/android/webview.html"}
+    - {old: "guide_platforms_blackberry10_config.md.html", new: "guide/platforms/blackberry10/config.html"}
+    - {old: "guide_platforms_blackberry10_index.md.html", new: "guide/platforms/blackberry10/index.html"}
+    - {old: "guide_platforms_blackberry10_plugin.md.html", new: "guide/platforms/blackberry10/plugin.html"}
+    - {old: "guide_platforms_blackberry10_tools.md.html", new: "guide/platforms/blackberry10/tools.html"}
+    - {old: "guide_platforms_blackberry10_upgrading.md.html", new: "guide/platforms/blackberry10/upgrading.html"}
+    - {old: "guide_platforms_blackberry_config.md.html", new: "guide/platforms/blackberry/config.html"}
+    - {old: "guide_platforms_blackberry_index.md.html", new: "guide/platforms/blackberry/index.html"}
+    - {old: "guide_platforms_blackberry_plugin.md.html", new: "guide/platforms/blackberry/plugin.html"}
+    - {old: "guide_platforms_blackberry_tools.md.html", new: "guide/platforms/blackberry/tools.html"}
+    - {old: "guide_platforms_blackberry_upgrading.md.html", new: "guide/platforms/blackberry/upgrading.html"}
+    - {old: "guide_platforms_firefoxos_config.md.html", new: "guide/platforms/firefoxos/config.html"}
+    - {old: "guide_platforms_index.md.html", new: "guide/platforms/index.html"}
+    - {old: "guide_platforms_ios_config.md.html", new: "guide/platforms/ios/config.html"}
+    - {old: "guide_platforms_ios_index.md.html", new: "guide/platforms/ios/index.html"}
+    - {old: "guide_platforms_ios_plugin.md.html", new: "guide/platforms/ios/plugin.html"}
+    - {old: "guide_platforms_ios_tools.md.html", new: "guide/platforms/ios/tools.html"}
+    - {old: "guide_platforms_ios_upgrading.md.html", new: "guide/platforms/ios/upgrading.html"}
+    - {old: "guide_platforms_ios_webview.md.html", new: "guide/platforms/ios/webview.html"}
+    - {old: "guide_platforms_tizen_index.md.html", new: "guide/platforms/tizen/index.html"}
+    - {old: "guide_platforms_win8_index.md.html", new: "guide/platforms/win8/index.html"}
+    - {old: "guide_platforms_win8_tools.md.html", new: "guide/platforms/win8/tools.html"}
+    - {old: "guide_platforms_win8_upgrading.md.html", new: "guide/platforms/win8/upgrading.html"}
+    - {old: "guide_platforms_wp7_index.md.html", new: "guide/platforms/wp7/index.html"}
+    - {old: "guide_platforms_wp8_index.md.html", new: "guide/platforms/wp8/index.html"}
+    - {old: "guide_platforms_wp8_plugin.md.html", new: "guide/platforms/wp8/plugin.html"}
+    - {old: "guide_platforms_wp8_tools.md.html", new: "guide/platforms/wp8/tools.html"}
+    - {old: "guide_platforms_wp8_upgrading.md.html", new: "guide/platforms/wp8/upgrading.html"}
+    - {old: "plugin_ref_plugman.md.html", new: "plugin_ref/plugman.html"}
+    - {old: "plugin_ref_spec.md.html", new: "plugin_ref/spec.html"}
+    - {old: "cordova_plugins_pluginapis.md.html", new: "cordova/plugins/pluginapis.html"}
+    - {old: "cordova_storage_database_database.md.html", new: "cordova/storage/database/database.html"}
+    - {old: "cordova_storage_localstorage_localstorage.md.html", new: "cordova/storage/localstorage/localstorage.html"}
+    - {old: "cordova_storage_parameters_display_name.md.html", new: "cordova/storage/parameters/display_name.html"}
+    - {old: "cordova_storage_parameters_name.md.html", new: "cordova/storage/parameters/name.html"}
+    - {old: "cordova_storage_parameters_size.md.html", new: "cordova/storage/parameters/size.html"}
+    - {old: "cordova_storage_parameters_version.md.html", new: "cordova/storage/parameters/version.html"}
+    - {old: "cordova_storage_sqlerror_sqlerror.md.html", new: "cordova/storage/sqlerror/sqlerror.html"}
+    - {old: "cordova_storage_sqlresultset_sqlresultset.md.html", new: "cordova/storage/sqlresultset/sqlresultset.html"}
+    - {old: "cordova_storage_sqlresultsetrowlist_sqlresultsetrowlist.md.html", new: "cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.html"}
+    - {old: "cordova_storage_sqltransaction_sqltransaction.md.html", new: "cordova/storage/sqltransaction/sqltransaction.html"}
+    - {old: "cordova_storage_storage.opendatabase.md.html", new: "cordova/storage/storage.opendatabase.html"}
+    - {old: "guide_platforms_amazonfireos_config.md.html", new: "guide/platforms/amazonfireos/config.html"}
+    - {old: "guide_platforms_amazonfireos_index.md.html", new: "guide/platforms/amazonfireos/index.html"}
+    - {old: "guide_platforms_amazonfireos_plugin.md.html", new: "guide/platforms/amazonfireos/plugin.html"}
+    - {old: "guide_platforms_amazonfireos_webview.md.html", new: "guide/platforms/amazonfireos/webview.html"}
+    - {old: "guide_platforms_ubuntu_index.md.html", new: "guide/platforms/ubuntu/index.html"}
+    - {old: "guide_support_index.md.html", new: "guide/support/index.html"}
+    - {old: "guide_appdev_hooks_index.md.html", new: "guide/appdev/hooks/index.html"}
+    - {old: "guide_appdev_security_index.md.html", new: "guide/appdev/security/index.html"}
+    - {old: "guide_next_index.md.html", new: "guide/next/index.html"}
+    - {old: "guide_platforms_android_upgrade.md.html", new: "guide/platforms/android/upgrade.html"}
+    - {old: "guide_platforms_blackberry10_upgrade.md.html", new: "guide/platforms/blackberry10/upgrade.html"}
+    - {old: "guide_platforms_blackberry_upgrade.md.html", new: "guide/platforms/blackberry/upgrade.html"}
+    - {old: "guide_platforms_firefoxos_index.md.html", new: "guide/platforms/firefoxos/index.html"}
+    - {old: "guide_platforms_ios_upgrade.md.html", new: "guide/platforms/ios/upgrade.html"}
+    - {old: "guide_platforms_win8_packaging.md.html", new: "guide/platforms/win8/packaging.html"}
+    - {old: "guide_platforms_win8_plugin.md.html", new: "guide/platforms/win8/plugin.html"}
+    - {old: "guide_platforms_win8_upgrade.md.html", new: "guide/platforms/win8/upgrade.html"}
+    - {old: "guide_platforms_win8_win10-support.md.html", new: "guide/platforms/win8/win10-support.html"}
+    - {old: "guide_platforms_wp8_parallels.md.html", new: "guide/platforms/wp8/parallels.html"}
+    - {old: "guide_platforms_wp8_upgrade.md.html", new: "guide/platforms/wp8/upgrade.html"}
+    - {old: "guide_platforms_wp8_vmware.md.html", new: "guide/platforms/wp8/vmware.html"}
+    - {old: "guide_platforms_wp8_webview.md.html", new: "guide/platforms/wp8/webview.html"}
+    - {old: "platform_plugin_versioning_ref_index.md.html", new: "platform_plugin_versioning_ref/index.html"}
+    - {old: "guide_getting-started_android_index.md.html", new: "guide/getting-started/android/index.html"}
+    - {old: "guide_getting-started_blackberry_index.md.html", new: "guide/getting-started/blackberry/index.html"}
+    - {old: "guide_getting-started_index.md.html", new: "guide/getting-started/index.html"}
+    - {old: "guide_getting-started_ios_index.md.html", new: "guide/getting-started/ios/index.html"}
+    - {old: "guide_getting-started_symbian_index.md.html", new: "guide/getting-started/symbian/index.html"}
+    - {old: "guide_getting-started_webos_index.md.html", new: "guide/getting-started/webos/index.html"}
+    - {old: "guide_getting-started_windows-phone_index.md.html", new: "guide/getting-started/windows-phone/index.html"}
+    - {old: "guide_upgrading_blackberry_index.md.html", new: "guide/upgrading/blackberry/index.html"}
+    - {old: "guide_upgrading_webos_index.md.html", new: "guide/upgrading/webos/index.html"}
+    - {old: "phonegap_accelerometer_accelerometer.md.html", new: "phonegap/accelerometer/accelerometer.html"}
+    - {old: "phonegap_camera_camera.md.html", new: "phonegap/camera/camera.html"}
+    - {old: "phonegap_compass_compass.md.html", new: "phonegap/compass/compass.html"}
+    - {old: "phonegap_connection_connection.md.html", new: "phonegap/connection/connection.html"}
+    - {old: "phonegap_contacts_contacts.md.html", new: "phonegap/contacts/contacts.html"}
+    - {old: "phonegap_device_device.md.html", new: "phonegap/device/device.html"}
+    - {old: "phonegap_events_events.md.html", new: "phonegap/events/events.html"}
+    - {old: "phonegap_file_file.md.html", new: "phonegap/file/file.html"}
+    - {old: "phonegap_geolocation_geolocation.md.html", new: "phonegap/geolocation/geolocation.html"}
+    - {old: "phonegap_media_capture_capture.md.html", new: "phonegap/media/capture/capture.html"}
+    - {old: "phonegap_media_media.md.html", new: "phonegap/media/media.html"}
+    - {old: "phonegap_notification_notification.md.html", new: "phonegap/notification/notification.html"}
+    - {old: "phonegap_storage_storage.md.html", new: "phonegap/storage/storage.html"}
+    - {old: "guide_getting-started_bada_index.md.html", new: "guide/getting-started/bada/index.html"}
+    - {old: "guide_upgrading_android_index.md.html", new: "guide/upgrading/android/index.html"}
+    - {old: "guide_upgrading_bada_index.md.html", new: "guide/upgrading/bada/index.html"}
+    - {old: "guide_upgrading_index.md.html", new: "guide/upgrading/index.html"}
+    - {old: "guide_upgrading_ios_index.md.html", new: "guide/upgrading/ios/index.html"}
+    - {old: "guide_upgrading_symbian_index.md.html", new: "guide/upgrading/symbian/index.html"}
+    - {old: "guide_upgrading_windows-phone_index.md.html", new: "guide/upgrading/windows-phone/index.html"}
+    - {old: "guide_whitelist_index.md.html", new: "guide/whitelist/index.html"}
+    - {old: "guide_command-line_index.md.html", new: "guide/command-line/index.html"}
+    - {old: "guide_cordova-webview_android.md.html", new: "guide/cordova-webview/android.html"}
+    - {old: "guide_cordova-webview_index.md.html", new: "guide/cordova-webview/index.html"}
+    - {old: "guide_cordova-webview_ios.md.html", new: "guide/cordova-webview/ios.html"}
+    - {old: "guide_plugin-development_android_index.md.html", new: "guide/plugin-development/android/index.html"}
+    - {old: "guide_plugin-development_bada_index.md.html", new: "guide/plugin-development/bada/index.html"}
+    - {old: "guide_plugin-development_blackberry_index.md.html", new: "guide/plugin-development/blackberry/index.html"}
+    - {old: "guide_plugin-development_index.md.html", new: "guide/plugin-development/index.html"}
+    - {old: "guide_plugin-development_ios_index.md.html", new: "guide/plugin-development/ios/index.html"}
+    - {old: "guide_plugin-development_webos_index.md.html", new: "guide/plugin-development/webos/index.html"}
+    - {old: "guide_plugin-development_windows-phone_index.md.html", new: "guide/plugin-development/windows-phone/index.html"}
+    - {old: "guide_getting-started_tizen_index.md.html", new: "guide/getting-started/tizen/index.html"}
+    - {old: "guide_plugin-development_tizen_index.md.html", new: "guide/plugin-development/tizen/index.html"}
+    - {old: "guide_upgrading_tizen_index.md.html", new: "guide/upgrading/tizen/index.html"}
+    - {old: "guide_getting-started_windows-8_index.md.html", new: "guide/getting-started/windows-8/index.html"}
+    - {old: "guide_project-settings_index.md.html", new: "guide/project-settings/index.html"}
+    - {old: "guide_project-settings_ios_index.md.html", new: "guide/project-settings/ios/index.html"}
+    - {old: "guide_getting-started_windows-phone-7_index.md.html", new: "guide/getting-started/windows-phone-7/index.html"}
+    - {old: "guide_getting-started_windows-phone-8_index.md.html", new: "guide/getting-started/windows-phone-8/index.html"}
+    - {old: "guide_project-settings_android_index.md.html", new: "guide/project-settings/android/index.html"}
+    - {old: "guide_project-settings_bada_index.md.html", new: "guide/project-settings/bada/index.html"}
+    - {old: "guide_project-settings_blackberry_index.md.html", new: "guide/project-settings/blackberry/index.html"}
+    - {old: "guide_project-settings_firefoxos_index.md.html", new: "guide/project-settings/firefoxos/index.html"}
+    - {old: "guide_project-settings_webos_index.md.html", new: "guide/project-settings/webos/index.html"}
+    - {old: "guide_project-settings_windows8_index.md.html", new: "guide/project-settings/windows8/index.html"}
+    - {old: "guide_project-settings_wp7_index.md.html", new: "guide/project-settings/wp7/index.html"}
+    - {old: "guide_project-settings_wp8_index.md.html", new: "guide/project-settings/wp8/index.html"}
+    - {old: "guide_getting-started_blackberry10_index.md.html", new: "guide/getting-started/blackberry10/index.html"}
+    - {old: "guide_plugin-development_blackberry10_index.md.html", new: "guide/plugin-development/blackberry10/index.html"}
+    - {old: "guide_privacy_index.md.html", new: "guide/privacy/index.html"}
+    - {old: "guide_upgrading_windows-8_index.md.html", new: "guide/upgrading/windows-8/index.html"}

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba6c2613/www/docs/en/deprecated.md
----------------------------------------------------------------------
diff --git a/www/docs/en/deprecated.md b/www/docs/en/deprecated.md
new file mode 100644
index 0000000..7a2b0f0
--- /dev/null
+++ b/www/docs/en/deprecated.md
@@ -0,0 +1,23 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: Deprecated Content
+---
+
+Sorry, this content is deprecated!


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


Mime
View raw message