Test Lab Guide (TLG) mini-modules are modular TLGs that just includes the essential configuration steps to get an existing and working test lab to a new working configuration, skipping the demonstration steps. In contrast, a typical modular TLG demonstrates key functionality, in addition to the essential configuration steps. TLG mini-modules are a content type in the Test Lab Guides content set. You can create your own TLG mini-module and publish it in the TechNet Wiki, the TechNet Gallery, or in your own publication venue.

You might write a TLG mini-module for the following reasons:

  • You just want to install a system component, product, or download, without configuring it for any specific purpose. 
  • You just want to get to a new working configuration of test lab as quickly as possible.

Also note the difference between a TLG mini-module and a test lab extension: A TLG mini-module is essentially a modular TLG, just abbreviated to get the test lab to a new configuration on which other modular TLGs can be built. A TLG extension takes you through the configuration and demonstration of some additional functionality, but does not leave the test lab in a configuration upon which other modular TLGs should be built.

This article describes the process for creating and publishing a TLG mini-module.

End-to-end process for creating and publishing a TLG mini-module

  1. Determine if the type of TLG content you want to publish is a TLG mini-module, a modular TLG, or a test lab extension. See Wiki: Creating and Publishing Test Lab Guide Content for more information on these TLG content types.
  2. If a TLG mini-module is the right type of content, determine the starting test lab configuration. For example, are you starting with the Windows Server 2012 base configuration or with a product or feature already configured? A starting test lab configuration will correspond to either a base configuration TLG or some other existing TLG. You will need to reference these TLGs in your TLG mini-module instructions.
  3. Outline the steps and procedures in your TLG mini-module to configure the desired feature, technology, or product.
  4. Build out the starting configuration test lab, using the appropriate set of TLGs, and then snapshot this configuration.
  5. Begin constructing your TLG mini-module. To help with this, use the Wiki: TLG Mini-module Template as a starting point. If you use this template, your TLG mini-module will have the same structure and boilerplate text as other TLG mini-modules, allowing the readers of your TLG mini-module to more quickly configure your test lab.
  6. Configure the test lab for the desired feature, technology, or product, documenting your steps and procedures as you go.
  7. When complete, restore the snapshots from step 4 and follow your documented steps to ensure that it works, refining your steps and procedures as needed. Repeat this step until your instructions and the desired test lab configuration results are solid and reproducible. If possible, hand your instructions to another person to follow and see if they are also successful.
  8. Add a TLG stack diagram to your TLG mini-module. This will show the set of TLGs that are needed and their order, with your new TLG mini-module at the top of the stack. For more information, see Wiki: Creating a TLG stack diagram.
  9. Add a TLG lab diagram to your TLG mini-module. This will show the set of computers and their connections to the test lab network. If your TLG mini-module does not add computers or subnets, you can use the TLG lab diagram from the TLG corresponding to your starting lab configuration. For more information, see Wiki: Creating a TLG lab diagram.
  10. Add helpful links to your TLG mini-module. Examples include links to evaluation versions of software, product or feature overview information, where to go to get help (such as online forums), and where to get information on additional or related TLG content (such as a TLG portal page).
  11. Publish your TLG mini-module. You can publish this in the TechNet Wiki (web article), the TechNet Gallery (white paper format), or in your own publication venue.
  12. Add a link to your TLG mini-module to the main Test Lab Guides portal page.
  13. Send a quick email to tlgfb@microsoft.com so that your new TLG mini-module can be announced in the Test Lab Guides blog.
  14. Advertise your new creation in your own social media outlets.

Example:

For more information, see Wiki: Creating and publishing Test Lab Guide content.