added documentation of design
added generated files to ignore