Add a note to custom hooks docs
Zendesk issue: https://gitlab.zendesk.com/agent/tickets/33327
Custom hooks that require specific runtime environments may not work when committing files using the GitLab web UI. For example, the customer in the attached Zendesk ticket was trying to lint the files using puppet
binary. The puppet
binary simply calls to the puppet
gem. The puppet
gem would need to be in the GitLab Gemfile for this to work. Pushes via SSH will work fine because the hooks are then executed in the context of the system environment, not the GitLab application. We should add a note to documentation suggesting that custom hooks work best when they are standard scripts that do not rely on external libraries. Ruby is fine, but calling another gem is going to be risky.