This content has been marked as final. Show 5 replies
I suggest you take a look at the topic on my site about merged webhelp as it will cover many of the questions.
You can create cross project links but remember they will break if they point to a child project that you don't deliver to a specific customer.
The limit to each project size is a practical one. There is no fixed number of pages or graphics. You get to point where you realise the project is taking a long time to open and is straining a bit. In my case that comes in around 4,000 to 5,000 topics in an individual project.
On multiple writers, on day 1 you both have a copy of the whole setup. You agree who works on what project and you never touch the other persons projects. Come generation time, you overwrite the projects in your setup that have been worked on by the other person.
I have a similar situation with one of my clients. Their HR and Payroll modules are so big in of themselves, I found it better to create a new project for each module. I have about 10 modules and the call center likes printed doc for the most part. So here's what I did.
I created 1 project per module (duplicating the templates, css, etc) so that all the projects look the same. I then link applicable items from 1 project to another using hyperlinks then merged all the projects to a master project and it looks seemless to the end user. I created a TOC of all the PDFs for the end user to print what they wanted in paper and sometimes included the PDF as a link on the topic. I posted all these projects on a server designated by their IT department. I have never heard any issues about doing it this way.
I like this option also because it keeps the projects kind of small, thereby speeding up the end users output.
Hope this helps. If you want more specific, just let me know.
Originally posted by: Kathy Maddox
And assuming they let me hire another writer someday, what's the best way to set up this kind of effort to support multiple writers?
Any insights or words of wisdoms you have will be greatly appreciated!
Actually, if you have a server, RH7 HTML comes with RoboSource which allows you to do simultaneous editing. If you disable this feature, you can still work on the same project by checking out just the topics you want to work on and then the other writer would check out other topics to work on.
Hi Peter and Cindy,
Wow. Thanks for your very fast and very informative replies. Sounds like I'll be okay with my approach of having one project/module and combining things at the master project level. I do use source control software (just not Robosource) so it's good to know that I can use it to manage a multi-writer, multi-project help system. As for the specifics of actually pulling things together, I'll just bookmark Peter's amazing site and refer to it as I go. But, Cindy, I was curous about your comment about PDFs. Do you include the PDFs as part of the help system that goes to the end user customer? What's the process for doing that? Right now, I create PDFs but they are only available from our Tech Support web site--we don't automatically distribute them to the customers.
If you want to include PDFs as an output that goes to the end user, just include them in your baggage folder and everything will ship together after you complie. I just started using RH7, but I would hope that they have not changed this functionality.
If you don't send the PDFs to the client, that's ok, so long as you can hyperlink to where the PDFs are (just include the whole path back to the tech support server). I have done this in the past with other clients, but my current client (a couple of years ago) migrated all my online help and documentation to the same servers so that all my projects, doc, powerpoint, and pdfs sit on the same internal server. So for this company there is no issue of linking to an outside source/server. The only issues I have is when they move or retire a server. Then I just simply republish all the projects again to the new server. Since the PDFs are part of the baggage folder everything remains intack.
Here is another great resource I've been using for years: http://www.robowizard.com/RoboWizard/NewProject.htm. Rick is very knowledgeable, I use his site a lot. He's got great Tips and Tricks. I should warn you though that his site is a bit different. Hope your into "Wizards". ;-)