Delete the old docs, lift up the new

.travis.yml

@@ -34,14 +34,7 @@ matrix:
       script:
         - cargo test
         - cargo doc --no-deps
-        - sh src/ci/dox.sh
-      after_success: |
-        [ $TRAVIS_BRANCH = master ] &&
-        [ $TRAVIS_PULL_REQUEST = false ] &&
-        [ $(uname -s) = Linux ] &&
-        pip install ghp-import --user &&
-        $HOME/.local/bin/ghp-import -n target/doc &&
-        git push -qf https://${GH_TOKEN}@github.com/${TRAVIS_REPO_SLUG}.git gh-pages 2>&1 >/dev/null
+        - (cd src/doc && mdbook build --no-create --dest-dir ../../target/doc)
 
   exclude:
     - rust: stable
@@ -51,13 +44,10 @@ before_script:
 script:
   - cargo test
 
-env:
-  global:
-    - secure: "hWheSLilMM4DXChfSy2XsDlLw338X2o+fw8bE590xxU2TzngFW8GUfq7lGfZEp/l4SNNIS6ROU/igyttCZtxZMANZ4aMQZR5E8Fp4yPOyE1pZLDH/LdQVXnROsfburQJeq+GIYIbZ01Abzh5ClpgLg5KX0H627uj063zZ7Ljo/w="
-
 notifications:
   email:
     on_success: never
+
 addons:
   apt:
     packages:

src/doc/README.md

@@ -1,6 +1,47 @@
-# Cargo Documentation
+# The Cargo Book
 
-NOTE: Cargo documentation is under migration to mdBook-based structure. All the
-`*.md` files here shall be kept in sync with the `*.md` files under `book/src/`.
-See `MIGRATION_MAP` file here and <https://github.com/rust-lang/cargo/pull/4453>
-for details.
+
+### Requirements
+
+Building the book requires [mdBook]. To get it:
+
+[mdBook]: https://github.com/azerupi/mdBook
+
+```shell
+$ cargo install mdbook
+```
+
+### Building
+
+To build the book:
+
+```shell
+$ mdbook build
+```
+
+The output will be in the `book` subdirectory. To check it out, open it in
+your web browser.
+
+_Firefox:_
+```shell
+$ firefox book/index.html                       # Linux
+$ open -a "Firefox" book/index.html             # OS X
+$ Start-Process "firefox.exe" .\book\index.html # Windows (PowerShell)
+$ start firefox.exe .\book\index.html           # Windows (Cmd)
+```
+
+_Chrome:_
+```shell
+$ google-chrome book/index.html                 # Linux
+$ open -a "Google Chrome" book/index.html       # OS X
+$ Start-Process "chrome.exe" .\book\index.html  # Windows (PowerShell)
+$ start chrome.exe .\book\index.html            # Windows (Cmd)
+```
+
+
+## Contributing
+
+Given that the book is still in a draft state, we'd love your help! Please feel free to open
+issues about anything, and send in PRs for things you'd like to fix or change. If your change is
+large, please open an issue first, so we can make sure that it's something we'd accept before you
+go through the work of getting a PR together.