diff --git a/json/Cargo.toml b/json/Cargo.toml
index c4c17c1..72b429d 100644
--- a/json/Cargo.toml
+++ b/json/Cargo.toml
@@ -13,3 +13,6 @@
 indexmap = { version = "1.0", features = ["serde-1"] }
 semver = { version = "0.9", features = ["serde"] }
 serde = { version = "1.0.88", features = ["derive"] }
+
+[dev-dependencies]
+serde_json = "1.0"
diff --git a/json/src/lib.rs b/json/src/lib.rs
index 0d70c7c..be0ac5f 100644
--- a/json/src/lib.rs
+++ b/json/src/lib.rs
@@ -24,6 +24,25 @@
 //! representation in syn.json from Rust code.
 //!
 //! [syn.json]: https://raw.githubusercontent.com/dtolnay/syn/master/syn.json
+//!
+//! ## Example
+//!
+//! ```
+//! use syn_codegen::Definitions;
+//!
+//! # const IGNORE: &str = stringify! {
+//! const SYN: &str = include_str!("syn.json");
+//! # };
+//! # const SYN: &str = include_str!("../../syn.json");
+//!
+//! fn main() {
+//!     let defs: Definitions = serde_json::from_str(SYN).unwrap();
+//!
+//!     for node in &defs.types {
+//!         println!("syn::{}", node.ident);
+//!     }
+//! }
+//! ```
 
 use indexmap::IndexMap;
 use semver::Version;