documentation a bit more optimised for touch devices; working well on ipad w/o crashes

closes #320