Create a variant sample matrix

Object Variants

Once you have identified your requirements, create a matrix showing how your sample content should be used in the output. Create some sample variant content - just enough to test with.

Test your plan by filtering and publishing the book and comparing the results to the matrix to ensure your approach is successful. Once you see that your requirements have been met, create the variant objects and apply your criteria to your production content.

Sample matrix

For example, the following matrix was used to test variants for regular and branched software releases. The branched releases have the letters A or B appended to the release number. Comparisons were made between the expected results, the content in the filtered book, and the content in the published output.

The first release for the sample content included the X1000 topics only. The second release included some updates to the X1000 topics and the introduction of the X2001 topics. The third and fourth releases were special branched builds. The fifth release introduced the X3001 content. Some content changes were made in the sixth and seventh releases.

Release update key

 -

=

this combination of product and release is not published

*x

=

the first instance of a topic during the release cycles

=

a new topic variant was created for changes in this release

 nc

=

there is no change in the current release; the topic from the previous release should be used

Topics for the products

Client

Product

Topic

Releases

1.0

1.1

1.1 A

1.1 B

1.2

2.0

2.0 A

Client 1

X1000

X1000 Intro

*x

x

nc

nc

x

nc

nc

X1000 Description

*x

x

nc

x

nc

nc

nc

X1000 Features

*x

nc

x

x

x

nc

nc

X1000 Specifications

*x

x

x

x

x

nc

nc

Client 2

X2001

X2001 Intro

-

*x

nc

nc

nc

x

nc

X2001 Description

-

*x

nc

nc

nc

nc

nc

X2001 Features

-

*x

nc

nc

nc

nc

x

X2001 Specifications

-

*x

nc

nc

nc

x

x

Client 1

X3001

X3001 Intro

-

-

-

-

*x

x

nc

X3001 Description

-

-

-

-

*x

x

x

X3001 Features

-

-

-

-

*x

nc

x

X3001 Specifications

-

-

-

-

*x

nc

nc