update docs

guide/src/python-from-rust/calling-existing-code.md

@@ -23,11 +23,6 @@ fn main() -> PyResult<()> {
 }
 ```
 
-[`PyModule::import`] introduces an overhead each time it's called. To avoid this in functions that are called multiple times,
-using a [`GILOnceCell`]({{#PYO3_DOCS_URL}}/pyo3/sync/struct.GILOnceCell.html) is recommended. Specifically, for importing types,
-[`GILOnceCell::import`]({{#PYO3_DOCS_URL}}/pyo3/sync/struct.GILOnceCell.html#method.import) is provided
-(check out the [example]({{#PYO3_DOCS_URL}}/pyo3/sync/struct.GILOnceCell.html#example-using-giloncecell-to-avoid-the-overhead-of-importing-a-class-multiple-times)).
-
 [`PyModule::import`]: {{#PYO3_DOCS_URL}}/pyo3/types/struct.PyModule.html#method.import
 
 ## Want to run just an expression? Then use `eval`.

src/sync.rs

@@ -224,7 +224,7 @@ where
     ///
     /// # Example: Using `GILOnceCell` to store a class in a static variable.
     ///
-    /// `GILOnceCell` can be used to avoid importing a class multiple times
+    /// `GILOnceCell` can be used to avoid importing a class multiple times:
     /// ```
     /// # use pyo3::prelude::*;
     /// # use pyo3::sync::GILOnceCell;

src/types/module.rs

@@ -79,6 +79,9 @@ impl PyModule {
     /// ```python
     /// import antigravity
     /// ```
+    ///
+    /// If you want to import a class, you can store a reference to it with
+    /// [`GILOnceCell::import`][crate::sync::GILOnceCell#method.import].
     pub fn import<N>(py: Python<'_>, name: N) -> PyResult<Bound<'_, PyModule>>
     where
         N: IntoPy<Py<PyString>>,