Documentation upgrades (#66)

.generator/src/generator/templates/lib.j2

@@ -1,6 +1,7 @@
 {% include "partial_header.j2" %}
 #![allow(non_camel_case_types)]
 #![allow(non_snake_case)]
+#![doc = include_str!("../README.md")]
 
 pub mod datadog;
 pub mod datadogV1;

Cargo.toml

@@ -16,6 +16,7 @@ include = [
     "/README.md",
     "/src/**/*",
     "/tests/**/*",
+    "/examples/*",
 ]
 keywords = [
     "datadog",
@@ -66,3 +67,10 @@ vcr-cassette = "2.0.1"
 [[test]]
 harness = false # allows Cucumber to print output instead of libtest
 name = "main"
+
+[[example]] # signal to Cargo that dev-dependencies are allowed for examples
+doc-scrape-examples = true
+name="v1_authentication_validate"
+
+[package.metadata.docs.rs]
+cargo-args = ["-Zunstable-options", "-Zrustdoc-scrape-examples"]

README.md

@@ -20,7 +20,7 @@ datadog-api-client = "0"
 
 Please follow the [installation](#installation) instructions and try the following snippet to validate your Datadog API key:
 
-```Rust
+```rust
 use datadog_api_client::datadog::configuration::Configuration;
 use datadog_api_client::datadogV1::api::api_authentication::AuthenticationAPI;
 

src/lib.rs

@@ -3,6 +3,7 @@
 // Copyright 2019-Present Datadog, Inc.
 #![allow(non_camel_case_types)]
 #![allow(non_snake_case)]
+#![doc = include_str!("../README.md")]
 
 pub mod datadog;
 pub mod datadogV1;