documentation improvements

some basic restructuring
I think this is a good place for following:
  
* 'ln -s assets/bower_components/semantic/dist/themes web/css'