Usability improvements after rewrite

Review docs, examples, tests to make sure they are clear and concise.

Consider bringing back (&deprecating) old register and implement etc. macros, expanding them to the new syntax