some more pseudocode and notes added
mostly use case descriptions