Re: [Framers] VSdocman Outputs to FM

2017-03-02 Thread Robert Lauriston
Most developers expect API documentation in HTML format these days. If you haven't done it before it may seem like a lot of overhead, but in the long run putting API documentation in the code and generating it automatically saves time and helps ensure accuracy. Seriously, take a look at

Re: [Framers] VSdocman Outputs to FM

2017-03-02 Thread cuc tu
Thank you for the suggestions. I looked at VSdocman with the developer. He has downloaded a trial version, so it is not a product the company currently uses. It is also a plug-in to VisualBasic IDE, which I do not have or use. His basic workflow is to click a tool in VS provided by the

Re: [Framers] VSdocman Outputs to FM

2017-03-02 Thread Robert Lauriston
I agree, if there's an API doc generator, using it would certainly be my first choice. You might also take a look at Document!X. That said, recent releases of FrameMaker reportedly do a much better job of importing Word. On Thu, Mar 2, 2017 at 9:01 AM, Monique Semp

Re: [Framers] Questions about tech docs in an Agile environment (may be off-topic)

2017-03-02 Thread Robert Lauriston
Can you be agile in a heavily regulated industry? https://www.ibm.com/developerworks/rational/library/compliant-agile-medical-device/ ___ This message is from the Framers mailing list Send messages to framers@lists.frameusers.com Visit the list's

Re: [Framers] VSdocman Outputs to FM

2017-03-02 Thread Monique Semp
Just wondering why the need to convert to FrameMaker at all? Why not just use VSdocman and create the appropriate output (http://www.helixoft.com/vsdocman/examples.html)? It purports to create HTML, CHM, PDF, XML, and more. That would mean, of course, that the result would likely be strictly

[Framers] VSdocman Outputs to FM

2017-03-02 Thread cuc tu
Hi All, A software team manager came to me asking for help creating an API manual. They had a specialized developer create about 200 API's and they need a manual in about a week. The developer has no time for documentation. My programming skills are very limited, but I have some light