Document the public API with detailed examples