anchor.diff:  That's it. You can now push to your _Main Repo_ and the `post-receive` hook will run `giblish` on the branches that you set it up to.
   
   === Setup the git hook and Jenkins scenario
  -
  -TBD...
   
   First, follow the steps described in <<common_setup>>. Then proceed with the steps below.
   
  
positive.code: 
  To describe how to use `giblish` as a tool for creating a static web site backed by a git repo that is automatically generated each time a contributor push changes to the git repo.
  
  This text covers the followwing deployment scenarios:app-name: 
  
   . Using a git hook together with a simple (well) shell script
   . Using a git hook together with Jenkins.
  
  They have been tested on Linux servers (Ubuntu). Most of the tools and scripts should work on a Windows server as well but might need some tweaking and is, again, not tested.
  
  If you want to dive straight in and setup one of the scenarios below, jump to <<setup_instructions>>, otherwise read on for some examples and considerations.
  
  == Git hook and shell script
  
  This requires the least number of dependencies to work but is more limited.
  
  .Deploy using git hook and shell script
  image::deploy_with_hooks.svg[]
  
negative.code:  * The hook and publish scripts provided with giblish runs synchronously at each push from a _Doc Writer_ to the _Main Repo_. The time it takes to generate the HTML docs from the adoc source will thus be added to each push to the _Main Repo_.
   * You need to manually setup the _Staging Repo_ on the server and this is a bit more 'hackish' than letting a build orchestrator tool implement a proper 'build' of your documents. You might for example end up with race conditions if two pushes to the _Main Repo_ are done close in time.
  
  == Using a combination of Jenkins and git hook
  
  This setup adds a Jenkins (or similar build orchestrator) installation so it is more tools to setup but offer more flexibility and performance. It is also more robust and thus more 'production friendly'.
  
  