google / mundane

Mundane is a Rust cryptography library backed by BoringSSL that is difficult to misuse, ergonomic, and performant (in that order).
MIT License
1.07k stars 46 forks source link

Build docs.rs documentation with all features enabled #21

Closed joshlf closed 5 years ago

joshlf commented 5 years ago

Now that we're using docs.rs to host our documentation, we need to add metadata to the Cargo.toml file to instruct docs.rs to use all build features when building the documentation. By default, it just uses the default features, meaning that we get no documentation for things like the insecure feature.

For details on how to do this, see the "Metadata for custom builds" section here. In particular, we'll want a section like this:

[package.metadata.docs.rs]
features = [ "bytes", "insecure", "..." ]

In total, we'll want the following features documented:

We'll also want to add a comment on the [features] line in Cargo.toml reminding developers to update the [package.metadata.docs.rs] section when they update the [features] section.

tsing80 commented 5 years ago

@joshlf: https://fuchsia-review.googlesource.com/c/mundane/+/325145