Beef up storage comments

Add a few comment adjustments and changes to
the storage layer code comments.

Change-Id: I6e8ca80473d4db7588aeacb06d00e5d6774e4f7e
Merge "Beef up storage comments"