partial README docs update
Merge branch 'docs'
various improvements: fix wrong ordering of elements in page; fix Errors
not updating when there's no error left; make custom tag name and its
model element id separate things (more explicit); add docs to various functions.