Problem with always having to re-import .htms
Howdy folks.
Background: Nearly two years ago (was using RH 7 at the time) we put our main help project under Mercurial source control--with somewhat less-than-desireable results. The way we have Mercurial setup, we basically have a development branch and a release branch. After our developers code something and it passes various tests, reviews, and is documented, it gets moved over (or transplanted) into the release branch and then pushed onto the server for anyone in our company to pull down into their local Mercurial repository. We only have myself and another writer who currently make changes inside the help project, and we communicate with each other so we're not working on the same topic at the same time. Whenever we release a version, I “update” my folder structure to the release branch. This pulls in all the changes that have made on the release branch, including our RH topic edits into my current help project. Then I can build the help with just the content on the release branch.
Problem: But something broke down along the way. I'm now using RH 9. I don't think the issue I'm seeing is a RH problem exactly, but it seems the way RH handles files and folders may have an affect on what's happening. Here's what's happening:
Whenever I update my help content to either the release branch or back to the development branch, I repeatedly have to re-import some .htm files back into the project. For example, I have a folder in my project named 13_hardware_topics. I always--or nearly always--have to re-import the .htms in that folder. Somehow they’re getting removed at least from whatever mechanism RH uses to determine files in a project. The .htm files still exist in the directory and haven't been manually deleted. RH just doesn't always recognize them. The folder, however, still exists inside of RH. Once they’re imported and I continue working on that branch, things are fine. At least things are fine until I have to switch back to a different branch, and then I have to re-import many of these same files again.
Also, we don’t track our CPD file in Mercurial, so we do end up with the problem of the CPD file from our development branch staying inside our release branch or vice versa when we do the branch switch. This isn’t too big of a problem as long as I remember to delete my CPD file before opening the project.
What file tells RH that a topic is part of a project? The .hhp file? Or is it the the .fpj file? Or something entirely different? Or does it get this info from more than one source? If so, what does it look at first?
My guess is that is what is screwed up (or gets screwed up on a branch change). I feel like shouting something like, "Massive hull damage Captain! Structural damage at 35% and climbing!" That's what the innards of this help project feels like. ![]()
