fix bad naming
improve the docs all over
remove warnings
update the docs tools
make the cells more compliant
allow tighter/more flexible type checks
raise a proper error