improve markdown and add unix compilation instructions
ignore generated files