Editions And Versions Fundamentals
Define Editions for multiple Browser Help Outputs (e.g. for Free, Standard, and Professional variants of a software product)
If you are using Single Sourcing features to generate multiple Browser Help outputs from your project, you should define an Edition for each Build Profile that generates Browser Help output to enable your users to switch between the different Browser Help outputs:
- Right-click on the Editions and Versions node in the Project Explorer and select Edit from the Context Menu.
- The Editions and Versions Editor opens.
- Select the Editions page.
- Click the toolbar button to add a new Edition.
- Define an appropriate ID and Caption for the Edition. Note that the ID value is used in generated help URLs.
- Select the Build Profile that generates the Browser Help output for this Edition.
When Building and Publishing, the Browser Help output for each Edition is published to a URL specific to the Edition. When your Browser Help outputs are built and published, end users of the Browser Help are able to use the "Edition" selector to switch between the documentation for the different Editions.
Define an initial Version if you want end users in future to be able to switch between documentation versions (e.g for a 1.0 version of a software product)
If you would like to publish multiple chronological versions of your documentation (e.g. to support multiple different versions of an application), you should define a new Version entry each time you publish a new version of the related application:
For the initial published version of the documentation:
- Right-click on the Editions and Versions node in the Project Explorer and select Edit from the Context Menu.
- The Editions and Versions Editor opens.
- Select the Versions page.
- Click the Create a new Version toolbar button to add the first Version.
- Type an ID and Caption for the new Version (e.g. 1.0).
- Select the This is the current Version option.
When building and Publishing, the Browser Help output for each Edition is published to a URL specific to Version 1.0. At this point, with just a single published version of the documentation, users do not see a "Version" selector in the documentation. But you still need to define the initial Version entry so that the Versions functionality is enabled in the generated output for the future (see below).
Define a new Version (e.g. for a 2.0 version of a software product)
- Right-click on the Editions and Versions node in the Project Explorer and select Edit from the Context Menu.
- The Editions and Versions Editor opens.
- Select the Versions page.
- Click the Create a new Version toolbar button to add the new Version.
- Type an ID and Caption for the new Version (e.g. 2.0).
- Select the This is the current Version option.
- Select the previous Version from the list (e.g. 1.0) and select the This Version is locked for publishing option. This prevents you from accidentally republishing the 1.0 copy of the documentation in future.
When building and Publishing, the Browser Help output for each Edition is published to a URL specific to Version 2.0.
Users of the 2.0 documentation now see a "Version" selector allowing them to switch between the 1.0 and 2.0 Version documentation.
Users of the 1.0 documentation also see a "Version" selector. This happens automatically thanks to the updated Editions and Versions configuration file shared by both 1.0 and 2.0, and does not require that the 1.0 documentation is modified or republished.