Fill out docstrings a bit more

Also add plot directive instructions to doc guide.