added some notes on what is still left to be documented