Docs updates

@zoni This should be right tup your alley.