Skip to main content
Participant
March 9, 2009
Question

Identifying Topics with Changes

  • March 9, 2009
  • 6 replies
  • 500 views
Hi -

I have a very large help file (700+ topics) that gets updated twice, if not three times a year. The changes range from subtle UI updates (such as field name changes) to a complete overahaul of existing topics to brand-new content. I am having a very hard time easily identifying which topics I've changed during the course of development. I am thinking of using the Priority Flags (Topic Properties>Status tab) as a method. However, I think I could easily forget to flag a topic before moving onto the next one. Can anyone share a method that works for them? I currently use a spreadsheet, but that is maddening.
    This topic has been closed for replies.

    6 replies

    March 9, 2009
    should add that I do one more thing, that end-users can actually see. Any change or addition in help topics is labeled as such, for at least one or two versions from its insertion. In other words, let's say I add a new topic for a new report form. At the top of the topic, under the title, I add

    New in Build 2.3.22

    or if this information is early,

    Coming in Build 2.3.22

    I also add this in the body of an existing topic to identify changes or new content in the topic.

    I can search on this phrase, and delete it after a few versions (our support and field staff like to see these labels in there too, so they can explain the history of changes in a process to clients, so they prefer that I don't remove them for a while).
    RoboWizard
    Inspiring
    March 9, 2009
    Hi all

    Joining the party a bit late on this.

    Does the link below help offer a possibility?
    Click here to read

    Cheers... Rick
    March 9, 2009
    and finally, yes, I do maintain a spreadsheet, on which each topic is listed with its map ID, last revision date and version, Topic Name, form name, File Name, and Notes. I share this with the programmer who updates the program with my help links from time to time, so he can use it to verify my map ID changes and additions. Yes, it is tedious, but for both of us it's a good sanity check / backup.
    March 9, 2009
    If you are just trying to cover your butt - meaning, that you want a way to know when changes were made and why in case anyone comes to you disputing the content, here's what I do.

    I created a small revisions table template, and put it in a DHTM drop-down, with the link (called Topic History) at the bottom of each topic. The table contains three columns: Revision Date, New Version Number, and Notes.

    Then, as changes are made, I update the version and detail the changes in the table. Because clients don't need to see this, I use a build tag to exclude it from the final build.
    RoboColum_n_
    Legend
    March 9, 2009
    Hi Mary.
    To add to Imarden's post, I've never saw the need to track changed topics and as the topic status tags available in RH7 and before were so limiting I just didn't bother when I did have to. RH8 however gives you the opportunity to define your own statuses. I've covered this on my blog.
    March 9, 2009
    You can assign a build tag to new / edited content to make it stand out from other topics and content. For example, I often insert content that is a version or two ahead of our current production build, so I want to be able to find that information easily and possibly hide it from clients. I give that content a build tag, named something like NewInVersion2. Then if I choose, I can get RH reports that list topics that contain build tags, or, I can exclude this new content from the build.
    March 9, 2009
    HI Mary. My suggestions sorta depend on what your goal is - why you need to know which topics have been changed, and what do you do with that information?