Skip to content

Commit

Permalink
Opt out -Zrustdoc-scrape-examples on docs.rs
Browse files Browse the repository at this point in the history
I'd like a chance to audit all the code that rustdoc is inserting into
the docs. Currently I am skeptical that showing semver's internal usages
of APIs is a net benefit to the public documentation. I am also
skeptical that quite so many examples are needed, and that they should
be featured so prominently in comparison to handwritten docs. Lastly I
wish there were a way to turn this behavior off on a more granular
basis.
  • Loading branch information
dtolnay committed Dec 18, 2022
1 parent 41f59f3 commit e3439b9
Showing 1 changed file with 3 additions and 0 deletions.
3 changes: 3 additions & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ std = []
[dependencies]
serde = { version = "1.0", optional = true, default-features = false }

[lib]
doc-scrape-examples = false

[package.metadata.docs.rs]
targets = ["x86_64-unknown-linux-gnu"]
rustdoc-args = ["--cfg", "doc_cfg", "--cfg", "semver_rustdoc_workaround"]

0 comments on commit e3439b9

Please sign in to comment.