diff --git a/README.md b/README.md
index 5b02608fd..1f70be704 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@ and
 
 ## Comparison with other FUSE libraries
 
-The FUSE library gained a new, cleaned-up API during a rewrite
+The FUSE library gained a new, cleaned-up API v2 during a rewrite
 completed in 2019. Find extensive documentation
 [here](https://godoc.org/github.com/hanwen/go-fuse/).
 
diff --git a/fs/api.go b/fs/api.go
index 644b91872..0341d7bf9 100644
--- a/fs/api.go
+++ b/fs/api.go
@@ -9,7 +9,7 @@
 // To create a file system, you should first define types for the
 // nodes of the file system tree.
 //
-//    struct myNode {
+//    type myNode struct {
 //       fs.Inode
 //    }
 //
@@ -19,7 +19,7 @@
 //    // Node types should implement some file system operations, eg. Lookup
 //    var _ = (fs.NodeLookuper)((*myNode)(nil))
 //
-//    func (n *myNode) Lookup(ctx context.Context, name string,  ... ) (*Inode, syscall.Errno) {
+//    func (n *myNode) Lookup(ctx context.Context, name string,  ... ) (*fs.Inode, syscall.Errno) {
 //      ops := myNode{}
 //      return n.NewInode(ctx, &ops, fs.StableAttr{Mode: syscall.S_IFDIR}), 0
 //    }