Skip to main content
J
Jenn_MM
Participating Frequently
November 6, 2008
Question

Single-sourcing with RH

  • November 6, 2008
  • 2 replies
  • 474 views
Hi All--
I'm thinking about maintaining all the topics for our documentation set in one main project since you cannot reference or 'point to' topics in other projects and generate printed documentation, but I'm concerned about the layer of complexity this is going to introduce to managing the project. Here are some of the tags, variables, etc. that I am considering:

*Maintaining separate TOCs for each deliverable (user guide, online Help)
*Using variables for AppNames, Version Number
*Creating a layout for generating each deliverable
*Creating build tags at the deliverable and print/online level.

Is this a credible strategy? Has anyone else done anything similar? Should I simplify it somewhat?
Thanks,
Jen
    This topic has been closed for replies.

    2 replies

    RoboColum_n_
    RoboColum_n_
    Legend
    November 7, 2008
    It sounds like you are between a rock and a hard place so there is no easy solution. Your approach would seem to be a workable solution.
    RoboColum_n_
    RoboColum_n_
    Legend
    November 6, 2008
    Hi Jen.

    Single sourcing to me means being able to generate more than one output (e.g. online help and a manual) from the same set of source files and with no or minimal tweaking. It is not putting all the source files for user guides and online help in the same project. - unless your user guide is just a printed copy of the help?

    That said, I could see your approach working but would be concerned at the complexity for the reasons stated above.
    J
    Jenn_MMAuthor
    Participating Frequently
    November 6, 2008
    The Help, User Guide, and Admin Guide do share a number of topics and, in some cases, chapters. I'm reorganizing a preexisting documentation set so it's easier to update (unfortunately reworking it is not an option). I think at some point in the past all the doc was output from RH for Word (It's in RoboHTML now), but I don't think any conditional tagging was applied.
    Terms & ConditionsAccessibility statement
    Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices