document the source key and flush out log convention. closes: #32