dont relink deprecated method when testing
fixed typo in error message
added/updated tests
started with docs, added a pub/sub example