compiled changes
documentation and a bit of reformatting