Missing step .gemspec file in guide

This is about http://guides.rubyonrails.org/engines.html#engine-setup, step 4.1 Mounting the Engine, showing how to add an engine named ‘blorgh’
It says to run bundle install. When I tried, I got an error message from bundler, that the blorgh .gemspec file was not valid. Plus an error like : path to blorgh not found, source empty.

I found that it had to do with some fields in the .gemspec file that needed to be updated (instead of the placeholders).

After I updated those fields, Bundler installed the gem without problems.

I would like to add this step to the documentation, but I am quite new to rails and I am not sure if I am correct here. So, two questions:

  1. Is my solution solving the right problem?

  2. Should I write an addittion to the guide, or just post an issue somewhere?

Thanks,

Maud