Namespace exceptions and update README

@nickdowse