== Orchard Autopkg Override Guidelines ==

 * You should only create overrides for .munki recipes
 * The override should contain:
  * An Attribution dict containing the copyright and author information dict. e.g.:
  {{{
  <key>Attribution</key>
     <dict>
       <key>Copyright</key>
       <string>University of Oxford 2016</string>
       <key>Author</key>
       <dict>
         <key>Name</key>
         <string>Ben Goodstein</string>
         <key>Email</key>
         <string>ben.goodstein at it.ox.ac.uk</string>
         <key>Github</key>
         <string>fuzzylogiq</string>
       </dict>
     </dict>
  }}}
  * The generic identifier starting with {{{local.munki.}}} that {{{autopkg make-override}}} inserts is fine.
  * In the {{{Input}}} dict:
   * Remove any keys/values that you are NOT intending to override, such as URLs and regexes that {{{make-override}}} has copied over from the parent recipes.
   * {{{NAME}}} should be set to the name of the software in title case with spaces expressed as underscores
   * {{{MUNKI_REPO_SUBDIR}}} (which should hopefully be exposed by the parent recipe) should be set to {{{%NAME%}}} (unless the software forms part of a suite of connected apps e.g. Microsoft_Office_2016
   * There should be a {{{pkginfo}}} dict with the following:
    * A {{{catalogs}}} array containing 'testing' (can be set to 'unstable' whilst doing internal testing but must be changed once in the auto-build)
    * A valid {{{category}}} (see this [[AutoPkg/Contributing/Categories|list of categories]])
    * A short {{{description}}} which should be free of marketing speak but should concisely describe the app and its function(s)
    * A {{{developer}}} (try to ensure that this matches other software by the same developer in the repo)
    * A {{{display_name}}} either set to {{{%NAME%}}} or the Name with spaces if more than one word.
    * A {{{name}}} set to {{{%NAME%}}}
    * {{{unattended_install}}} set to {{{True}}}
  * The {{{ParentRecipe}}} should, of course, be set to the Identifier of the recipe you are overriding, the {{{autopkg make-override}}} command should take care of this too.