I am referring to the examples that come from
examples/ directory of a crate in the default configuration, or whatever is specified as
[[example]] in the Cargo.toml.
When I use a crate dependency, I will generally look at its documentation on docs.rs. I am not in the habit of going into the source repository, especially since the docs.rs page usually includes its own copy of the source code. However I realized today that the rustdocs do not include examples so the source repository is the only place to see the examples. Anything that a crate author puts in
[[example]] instead of
[[test]] is probably intended to serve as documentation in some way, so would it make sense for rustdoc to package up the source code of all examples and include them in the docs?