plotter documentation and code clean up

Change-Id: I0acb897f3a6b3dd5ba1317e4876faf3ef4fb938b
Reviewed-on: http://review.couchbase.org/31432
Tested-by: buildbot <build@couchbase.com>
Reviewed-by: Pavel Paulau <pavel.paulau@gmail.com>