more example tests and docs