Create a new version

A version contains the actual documentation objects.

When users add a new object, they must add it to a version. A version must therefore exist before content can be added to it, and the same content object can be used in more than one version.

You have three options for creating a new version:
  • Creating a completely new, empty version.
  • Creating a version based on an existing version. All the objects in the existing version are added to the new version. This option is displayed only if versions are available for the product or library.
  • Creating a new version based on a version tag. All the objects in the version tag are added to the new version. This option is displayed only if tags are available for the product or library.

Versions have the file extension .version but they are XML files and so they can be most easily edited in your preferred XML editor. You should add a default editor to .version files in your Eclipse preferences so that the versions that you want to edit are opened automatically in your preferred editor.

To create a new version:

  1. In the Dynamic Release Management view, right-click the release to which you want to add a version and select New Version.
    The Create Version dialog box is displayed:
    Create Version
  2. Give the version name and a description.
  3. Specify the language for the version in the Language field.
  4. If another version or a version tag exists for this product/library, the Based On field is displayed. Select one of the following:
    Option Description
    NEW Version Creates a new, empty version.
    Version

    When you select Version in the Based On field, all the available versions for the product/library are listed. Select the version that you want to copy. All the objects in the existing version are added to the new version.

    This option is displayed only if versions are available for the product/library.

    Tag

    When you select Tag in the Based On field, all the available tags for the product/library are listed. Select the version tag that you want to copy. All the objects in the version tag are added to the new version. This option is displayed only if tags are available for the product/library.

  5. (Optional) Click the Save Settings button to save the Language setting for the next time that you create a version tag.
  6. Click OK.
    The version is created and displayed in the Dynamic Release Management view under the appropriate release.