kitchen docs are... not correct

[jaymzh]

Description

The kitchen docs generated ... are woefully wrong.

For starters, if people do what Chef does and make omnibus a directory inside of their git repo, then the data dropped off into the vagrant VM is simply the 'omnibus' directory which means you can't actually build, all of the references to the parent directory for the actual source... isn't there.

Second, it claims you should bundle install as the vagrant user, but this isn't the case:

vagrant@default-ubuntu-1804:~/sugarjar$ bundle install
Following files may not be writable, so sudo is needed:
  /opt/omnibus-toolchain/embedded/bin
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0/build_info
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0/build_info/mini_portile2-2.4.0.info
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0/build_info/nokogiri-1.10.9.info
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0/cache
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0/doc
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0/extensions
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0/gems
  /opt/omnibus-toolchain/embedded/lib/ruby/gems/2.6.0/specifications
There was an error while trying to write to
`/home/vagrant/.bundle/cache/compact_index/rubygems.org.443.29b0360b937aa4d161703e6160654e47/versions`.
It is likely that you need to grant write permissions for that path.

If you then try to sudo bundle install and then get the build going you will fail to write to:

There was an error while trying to write to
`/home/vagrant/.bundle/cache/compact_index/rubygems.org.443.29b0360b937aa4d161703e6160654e47/versions`.

And that happens regardless of if you run the build as root or not. Oddly even if you change the permissions, they return back to 444.

Omnibus Version

Omnibus v7.0.13

Platform Version

ubuntu 18.04 --- in the VM. debian sid outside.