adds some explanations and project gemfile