First published on TECHNET on Jan 13, 2011

The following are some best practices that should be followed when documenting configuration packs.  This list of best practices is not inclusive and is only a recommendation.

  • All configuration packs should include a word document that describes each configuration baseline, item, setting and rule.
  • Each setting and rule should include the following inline in the configuration pack…
    • Summary of what the rule is checking
    • Expected value for the setting
    • Why is this setting important
    • How to fix this setting if not compliant
  • All configuration packs should include a readme that details how to import the configuration pack
  • All documents should be shipped inside configuration pack MSI
  • All documents should also be shipped outside configuration pack to allow for direct download
  • All documentation should be proofed for grammar and spelling