• Global community
    • Language:
      • Deutsch
      • English
      • Español
      • Français
      • Português
  • 日本語コミュニティ
    Dedicated community for Japanese speakers
  • 한국 커뮤니티
    Dedicated community for Korean speakers

Managing multiple versions and adding them to navigation

Community Beginner ,
Oct 27, 2022 Oct 27, 2022

Copy link to clipboard

Copied

1. What is the best way to maintain documentation for multiple versions of products?
2. How can we make corresponding versions of the doc accessible to the user from the output?
Preferably by adding a dropdown listing all versions in the Top Nav (Header Links in the Frameless Skin). 

OR something like we see here.image.png

Views

49

Likes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Oct 27, 2022 Oct 27, 2022

Copy link to clipboard

Copied

Ok, so that page was built using Antorra - totally different toolset than RH. Maybe Dynamic Content Filtering or merged help might work - see https://www.grainge.org/pages/authoring/rh_tour/rh2022/outputs/dynamic_content.htm and https://www.grainge.org/pages/authoring/rh_tour/rh2022/authoring/merged_help.htm

Likes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Beginner ,
Oct 27, 2022 Oct 27, 2022

Copy link to clipboard

Copied

Hi Jeff,

Thank you for your reply.

We publish the output to a repo with a commit message, which changes with each version like v01, v02. Each time we push the changes to the repo it creates the corresponding folder structure in the IIS site's root directory so that users can change only the version name in the URL.

In Antora also, based on the branch/ version we set in the antora.yml the output is generated in the respective directory. We have set our Azure DevOps pipeline as follows.

Solution 1: I didn't understand how it could be used for my use case.

Solution 2: Merged help. Doesn't it require that we maintain child projects for each version?
How can we get separate TOC for child pages?

Likes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Oct 28, 2022 Oct 28, 2022

Copy link to clipboard

Copied

I'm sorry, but are you already using Antorra to generate help content sites? Why would you be using RH in that case? Wouldn't all your content be authored in Markdown or ASCIIDoc or something more "docs-as-code"?

Likes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Oct 28, 2022 Oct 28, 2022

Copy link to clipboard

Copied

In terms of multiple versions, see RoboHelp Tour Introduction (grainge.org). That is effectively different versions. You could have a menu where they all sit under one heading and then have headings for other content.

 

Like @Jeff_Coatsworth I don't get why you are mixing two tools to generate content.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

 

Help others by clicking Correct Answer or Like if helpful. Found your answer elsewhere? Share it here.

Likes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Beginner ,
Oct 28, 2022 Oct 28, 2022

Copy link to clipboard

Copied

Thank you @Jeff_Coatsworth and @Peter Grainge 
I shall check this solution suggested by  @Peter Grainge  My present organization isn't using Antora. I was citing it to help you understand my exact requirement. Apologies if it has led to confusion. 

Likes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Oct 28, 2022 Oct 28, 2022

Copy link to clipboard

Copied

LATEST

Your link is to a site that has been designed in a very different tool requiring a knowledge of tools such as Dreamweaver. They allow those with the skills to create any website.

 

RoboHelp simplifies that task and provides various features such as being able to create builds with different content, search functionality, browse sequences and so on. All things you would have to code yourself.

 

Top Navigation offers a degree of dropdown but it doesn't work too well with big TOCs. Those dropdowns are functionally the same as the TOC I pointed you too. 

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

 

Help others by clicking Correct Answer or Like if helpful. Found your answer elsewhere? Share it here.

Likes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Resources
RoboHelp Documentation
Download Adobe RoboHelp