updated docs & added coverage