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:
When Building and Publishing, the Browser Help output for each Edition will be published to a url specific to the Edition. When your Browser Help outputs are built and published, end users of the Browser Help will be 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:
When building and Publishing, the Browser Help output for each Edition will be published to a url specific to Version 1.0. At this point, with just a single published version of the documentation, users will 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)
When building and Publishing, the Browser Help output for each Edition will be published to a url specific to Version 2.0.
Users of the 2.0 documentation will now see a "Version" selector allowing them to switch between the 1.0 and 2.0 Version documentation.
Users of the 1.0 documentation will now 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.