extend readme and literate test suite