Update documentation

@cdeil - do you want to review this?