WIP: Test code examples in README

README.md

@@ -19,7 +19,7 @@
 
 A crate for safe and ergonomic pin-projection.
 
-[Documentation](https://docs.rs/pin-project/)
+[Documentation][docs-url]
 
 ## Usage
 

azure-pipelines.yml

@@ -11,6 +11,7 @@ trigger:
 - master
 - staging
 - trying
+- external_doc # WIP
 
 variables:
   RUSTFLAGS: -Dwarnings

src/lib.rs

@@ -87,6 +87,17 @@
 #![warn(single_use_lifetimes)]
 #![warn(clippy::all, clippy::pedantic)]
 #![allow(clippy::use_self)]
+#![cfg_attr(test, feature(external_doc))]
+
+#[cfg(test)]
+mod _doctests {
+    #[doc(include = "../README.md")]
+    const _README: () = ();
+    #[doc(include = "../doc/struct-example-1.md")]
+    const _STRUCT_EXAMPLE: () = ();
+    #[doc(include = "../doc/enum-example-1.md")]
+    const _ENUM_EXAMPLE: () = ();
+}
 
 #[doc(hidden)]
 pub use pin_project_internal::pin_project;