Added documentation about assumptions + comment aesthetics

Adding documentation details mentioned in #30