cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblotsky <...@git.apache.org>
Subject [GitHub] cordova-docs pull request #737: CB-13333: Move "Instructions" to /doc
Date Tue, 26 Sep 2017 21:18:48 GMT
Github user dblotsky commented on a diff in the pull request:

    https://github.com/apache/cordova-docs/pull/737#discussion_r141187905
  
    --- 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 --
    
    It's not wrong. It was just all one section before, so I'm wondering why you split it
into two sections. Both are OK.


---

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


Mime
View raw message