cleans up documentation, adds another example