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

2017-02-27 Thread Pat Christenson
My company has a very large suite of products and I'm the only tech writer. Software is developed in an agile environment, with some products releasing new features every 2 weeks. The largest product updates quarterly. I can easily spend almost a month on its release notes. We are using FrameMak

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

2017-02-27 Thread Hedley Finger
Can you write the release notes in such a way that the content can be embedded as an insert into the user guide? Can you automate the production flow to some extent? Can time consuming tasks like repagination that do not affect content be hived of to a non-technical assistant? Could you get a less

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

2017-02-27 Thread Alastair Dent
Subject: [Framers] Questions about tech docs in an Agile environment (may be off-topic) My company has a very large suite of products and I'm the only tech writer. Software is developed in an agile environment, with some products releasing new features every 2 weeks. The largest product upd

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

2017-02-28 Thread Caroline Tabach
@lists.frameusers.com] On Behalf Of Pat Christenson Sent: Tuesday, February 28, 2017 12:43 AM To: fram...@frameusers.com Subject: [Framers] Questions about tech docs in an Agile environment (may be off-topic) My company has a very large suite of products and I'm the only tech writer. Sof

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

2017-02-28 Thread Robert Lauriston
If there's only one writer and not enough time to do everything, detailed release notes don't seem like the best choice. Seems like an opportunity for reuse. I'm a solo tech writer and Paligo allows me to manage reuse in such a way that I'm more productive. Flare over RoboHelp. Its FrameMaker imp

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

2017-03-01 Thread cuc tu
he nuts and bolts of their use, overhead, and real returns. Sometimes the marketing seems to get in the way... Thanks, C -- Message: 5 Date: Mon, 27 Feb 2017 22:43:16 + From: Pat Christenson To: "fram...@frameusers.com" Subject: [Framers] Questions about

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

2017-03-01 Thread Robert Lauriston
Adopting a non-reality-based editorial process is one of the most common ways of doing Agile wrong. I think that's often based on a misreading of the part of the Agile manifesto that says, "Working software over comprehensive documentation." That refers to developer-written documentation such as sp

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

2017-03-01 Thread Robert Lauriston
I used Confluence Server plus Scroll PDF Exporter and HTML Exporter plugins for three years (just for authoring, not for hosting docs), then migrated to Paligo last August. The big plus of Confluence was that reviews were really easy. The biggest minus is that Atlassian doesn't fix bugs, so I had

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 homep

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

2017-03-07 Thread Pat Christenson
roup every now and then on what we're learning and how we're handling it. Thank you again for your thoughtful input! Pat -Original Message- From: Framers [mailto:framers-bounces+pat.christenson=morningstar@lists.frameusers.com] On Behalf Of Robert Lauriston Sent: Thursday,

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

2017-03-09 Thread Pat Christenson
Tuesday, March 07, 2017 9:09 AM To: An email list for people using Adobe FrameMaker software. Subject: Re: [Framers] Questions about tech docs in an Agile environment (may be off-topic) Thank you all for the information! Naturally, there have been developments here since I asked my quest