adding a little more explanation to the doc