start to document where items are stored in memory and in the output file
more ideas
w-i-p
executable
documentation TODO