diff --git a/src/fs/mod.rs b/src/fs/mod.rs
index fa95059..3906eae 100644
--- a/src/fs/mod.rs
+++ b/src/fs/mod.rs
@@ -1,10 +1,10 @@
 //! Provides an injectable reference to part of the filesystem.
 //!
-//! Create a new `FileSystem` to access a directory using `kxio::fs::new(path)`.
-//! Create a new `TempFileSystem` to access a temporary directory using `kxio::fs::temp()?`;
+//! Create a new [FileSystem] to access a directory using [crate::fs::new].
+//! Create a new [TempFileSystem] to access a temporary directory using [crate::fs::temp()].
 //!
-//! `TempFileSystem` derefs automatically to `FileSystem` so can be used anywhere
-//! you would use `FileSystem`.
+//! [TempFileSystem] derefs automatically to [FileSystem] so can be used anywhere
+//! you would use [FileSystem].
 //!
 //! ```
 //! # use std::path::PathBuf;
@@ -29,12 +29,12 @@
 //!
 //! # Standard library equivalents
 //!
-//! Given a `FileSystem` `fs`:
+//! Given a [FileSystem] `fs`:
 //!
 //! ```no_run
 //! let fs = kxio::fs::temp().expect("temp fs"); // for testing
 //! // or
-//! # let pathbuf = fs.base().join("foo").to_path_buf();
+//! # let pathbuf = fs.base().join("foo");
 //! let fs = kxio::fs::new(pathbuf);
 //! ```
 //!