The description isn't that obvious for people that don't know what notational velocity is or how it works.
But to be fair, the first thing the readme says is a paraphrasing of the blurb at, and a link to, the notational velocity homepage.
And the gif, which I usually like, suffers the same problem. Hard to follow unless you already know what it is.
In the end I decided it wasn't for me, tons of small files, each per note? Didn't seem that compelling to me, I think I would prefer one or a few larger files maybe something like vim-wiki.
But because I couldn't quickly research it feel I might have misunderstood it.