diff --git a/vendor/pyo3/pyo3-ffi/src/lib.rs b/vendor/pyo3/pyo3-ffi/src/lib.rs
index 23a5e0000..4333b7cf0 100644
--- a/vendor/pyo3/pyo3-ffi/src/lib.rs
+++ b/vendor/pyo3/pyo3-ffi/src/lib.rs
@@ -129,9 +129,7 @@
 //! ```
 //!
 //! **`src/lib.rs`**
-//! ```rust
-#![doc = include_str!("../examples/string-sum/src/lib.rs")]
-//! ```
+//! see: `../examples/string-sum/src/lib.rs`
 //!
 //! With those two files in place, now `maturin` needs to be installed. This can be done using
 //! Python's package manager `pip`. First, load up a new Python `virtualenv`, and install `maturin`
diff --git a/vendor/pyo3/src/lib.rs b/vendor/pyo3/src/lib.rs
index c71e12b86..3af3aadff 100644
--- a/vendor/pyo3/src/lib.rs
+++ b/vendor/pyo3/src/lib.rs
@@ -463,7 +463,7 @@ pub use pyo3_macros::{
 
 /// A proc macro used to expose Rust structs and fieldless enums as Python objects.
 ///
-#[doc = include_str!("../guide/pyclass-parameters.md")]
+/// see: `../guide/pyclass-parameters.md`
 ///
 /// For more on creating Python classes,
 /// see the [class section of the guide][1].