Github user dblotsky commented on a diff in the pull request:
https://github.com/apache/cordova-docs/pull/737#discussion_r141174635
--- Diff: doc/redirects.md ---
@@ -0,0 +1,53 @@
+# Redirects
+
+Sometimes (docs) pages get removed, renamed, and added. There is [a
redirects file](../www/_data/redirects.yml) that contains redirects for such
occasions. It has three sections:
+
+- `general`: single-page redirects.
+- `docs-global`: redirects across all docs versions and languages,
+- `docs`: version-specific docs redirects, and
+
+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 301) redirects. Incorrect permanent
redirects will make a URI almost impossible to bring back into browsers and
search indices.
+
+## Changing Docs URIs
--- End diff --
Why is this a new section?
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
