(docs) information on usage
(docs) change demo to example
(fix) instantiation and validator