diff --git a/fern/products/docs/pages/api-references/library-docs.mdx b/fern/products/docs/pages/api-references/library-docs.mdx
index e00a59ce9..5396750d7 100644
--- a/fern/products/docs/pages/api-references/library-docs.mdx
+++ b/fern/products/docs/pages/api-references/library-docs.mdx
@@ -4,7 +4,9 @@ description: Generate MDX documentation pages from your Python or C++ library so
 ---
 
 
-The library docs generator parses your **Python or C++** library source code and generates MDX documentation pages for modules, classes, functions, methods, and parameters. Generated pages include cross-reference links and hierarchical navigation, and are integrated directly into your Fern Docs site.
+The library docs generator parses your **Python or C++** library source code and generates MDX documentation pages for modules, classes, functions, methods, and parameters. Generated pages are added to your Fern Docs site with hierarchical navigation.
+
+Cross-links are automatic. When a fully-qualified identifier appears in a code block — for example, in a class signature or type annotation — the generator links it to the page documenting that symbol, so readers can jump straight to the definition.
 
 ## Configuration