Documentary comments for storm internals

Added documentary comments to the critical pieces of executor and acker code.