Set up crates for self-hosted docs.

Fixes #57

Author: Arnavion

CONTRIBUTING.md

@@ -63,7 +63,20 @@ The repository supports the latest patch versions of each of the separate 1.x re
 
 # To make a new crate release
 
-1. `/k8s-openapi/Cargo.toml`: Update crate version
+1. `/Cargo.toml`: Update crate version
+1. `/Cargo.toml`: Update docs URL
 1. `/k8s-openapi-codegen-common/Cargo.toml`: Update crate version
 1. `/k8s-openapi-derive/Cargo.toml`: Update crate version
 1. `/k8s-openapi-derive/Cargo.toml`: Update version req of `k8s-openapi-codegen-common` dependency
+1. `/k8s-openapi-derive/Cargo.toml`: Update docs URL
+1. Generate docs (change feature and directory name as appropriate).
+
+    ```sh
+    rm -rf ./target/doc/ &&
+    cargo rustdoc --features 'v1_16' -- -Z unstable-options --disable-per-crate-search --enable-index-page &&
+    CARGO_TARGET_DIR="$(realpath ./target)" cargo rustdoc --manifest-path ./k8s-openapi-derive/Cargo.toml -- -Z unstable-options --disable-per-crate-search --enable-index-page &&
+    rm -rf ../k8s-openapi-gh-pages/v0.6.x &&
+    cp -R ./target/doc ../k8s-openapi-gh-pages/v0.6.x
+    ```
+
+1. `../k8s-openapi-gh-pages/index.html`: Add new anchor if this is a new major release

Cargo.toml

@@ -5,7 +5,7 @@ license = "Apache-2.0"
 authors = ["Arnavion <[email protected]>"]
 categories = ["api-bindings", "web-programming::http-client"]
 description = "Bindings for the Kubernetes client API"
-documentation = "https://docs.rs/k8s-openapi"
+documentation = "https://arnavion.github.io/k8s-openapi/v0.6.x/k8s-openapi/"
 edition = "2018"
 keywords = ["client", "kubernetes", "k8s", "http"]
 readme = "README.md"

README.md

@@ -2,7 +2,7 @@ This crate is a Rust Kubernetes API client. It contains bindings for the resourc
 
 [crates.io](https://crates.io/crates/k8s-openapi)
 
-[Documentation](https://docs.rs/k8s-openapi)
+[Documentation](https://arnavion.github.io/k8s-openapi/)
 
 [Changelog](https://github.com/Arnavion/k8s-openapi/blob/master/CHANGELOG.md)
 

k8s-openapi-derive/Cargo.toml

@@ -5,7 +5,7 @@ license = "Apache-2.0"
 authors = ["Arnavion <[email protected]>"]
 categories = ["api-bindings", "web-programming::http-client"]
 description = "Custom derives for the Kubernetes client API"
-documentation = "https://docs.rs/k8s-openapi-derive"
+documentation = "https://arnavion.github.io/k8s-openapi/v0.6.x/k8s-openapi-derive/"
 edition = "2018"
 keywords = ["client", "kubernetes", "k8s", "http"]
 readme = "README.md"

k8s-openapi-derive/README.md

@@ -6,7 +6,7 @@ See crate docs for details.
 
 [crates.io](https://crates.io/crates/k8s-openapi-derive)
 
-[Documentation](https://docs.rs/k8s-openapi-derive)
+[Documentation](https://arnavion.github.io/k8s-openapi/)
 
 [Changelog](https://github.com/Arnavion/k8s-openapi/blob/master/CHANGELOG.md)
 

k8s-openapi-derive/src/lib.rs

@@ -269,7 +269,7 @@ impl<T, E> ResultExt<T> for Result<T, E> where E: std::fmt::Display {
 ///
 /// (You may wish to generate your own crate's docs, or run it through `cargo-expand`, to be able to see the macro expansion.)
 ///
-/// Refer to [the `k8s-openapi` crate docs](https://docs.rs/k8s-openapi) to learn more about how to use the return values of these functions.
+/// Refer to [the `k8s-openapi` crate docs](https://arnavion.github.io/k8s-openapi/) to learn more about how to use the return values of these functions.
 ///
 /// See the [`custom_resource_definition` test in the repository](https://github.com/Arnavion/k8s-openapi/blob/master/k8s-openapi-tests/src/custom_resource_definition.rs)
 /// for a full example of using this custom derive.