Issue 3637 - Generate source code documentation on the web server

modules/web/manifests/server.pp

 class web::server(
     $vhost,
     $repository,
     $certificate = hiera('web::server::certificate', 'undef'),
     $private_key = hiera('web::server::private_key', 'undef'),
     $is_default = false,
     $aliases = undef,
     $custom_config = undef,
     $multiplexer_locations = undef,
     $geoip = false,
@@ skipping 86 matching lines @@
   }
 
   file {'/var/www':
     ensure => directory,
     mode => 755,
   }
 
   file {[
     "/var/cache/$repository",
     "/var/www/$vhost",
+    "/var/www/docs",
   ]:
     ensure => directory,
     owner => www,
     mode => 755,
   }
 
   cron {'update_cms':
     ensure => present,
     command => "hg pull -q -u -R /opt/cms",
     minute  => '5-55/10',
   }
 
   cron {'update_repo':
     ensure => present,
     command => "hg pull -q -R /home/www/${repository} && python -m cms.bin.generate_static_pages /home/www/${repository} /var/www/${vhost}",
     user => www,
     minute  => '*/10',
   }
+
+  # We have to set up the APT source and install the jsdoc package via npm
+  # manually. Once we're on Puppet 3, we can use the official nodejs module for
+  # all this: https://forge.puppetlabs.com/puppetlabs/nodejs
+
+  apt::source {'nodesource':
+    location => 'https://deb.nodesource.com/node_4.x',
+    release => 'precise',
+    repos => 'main',
+    key => '68576280',
+    key_content => template('web/nodesource.gpg.key.erb'),
+  }
+
+  package {'nodejs':
+    require => Apt::Source['nodesource'],
+  }
+
+  exec {'install_jsdoc':
+    command => 'npm install --global jsdoc',
+    path => ['/usr/bin/'],
+    require => Package['nodejs'],
+    onlyif => 'test ! -x /usr/bin/jsdoc',
+  }
+
+  package {'doxygen':}
+
+  cron {'generate_docs':
+    ensure => present,
+    require => [
+      Exec['fetch_sitescripts', 'install_jsdoc'],
+      Package['doxygen'],
+      File['/var/www/docs'],
+    ],
+    command => 'python -m sitescripts.docs.bin.generate_docs',
+    user => www,
+    minute => '5-55/10',
+  }
 }