tweaked documentation

@sol