Wiki to doc tests

[mike-kfed]

second attempt to fix issue #115

I did not include the example using structopt since that does not compile on your CI tests.

the link to the attributes page of the wiki remains. didn't figure out where to put this in the code (maybe extra rust source file that is just documentation?)

[jplatte]

the link to the attributes page of the wiki remains. didn't figure out where to put this in the code (maybe extra rust source file that is just documentation?)

I think what you could do for attributes is have one .md file per attribute that describes that attribute, and add

///
/// # Attributes
///
#[doc(include("attr_foo.md"))]
#[doc(include("attr_bat.md"))]

at the end of the docs for every drive macro that supports a set of attributes.

[mike-kfed]

while a good idea, this is experimental see rust-lang/rust#44732

I'd rather wait for this to be stabilised.

[jplatte]

Oh, I thought that was stable. In that case I might make a PR adding sth like this behind a feature flag later but that probably shouldn't block the current work.

[Peternator7]

This is super great! Thanks for taking on this work. I'll merge it and push a patch version to crates today so docs.rs picks up the new version.