Adobe FrameMaker Pet Peeve: No Way to Edit and Delete Conditional Text Tags Wholesale Across All the Chapters of a Book
© Ugur Akinci Adobe FrameMaker is a great product that I’ve been using for over 15 years now. It’s dependable, scalable, and won’t leave you stranded in the midst of a project by crashing (unless you run out of RAM, which is a possibility when you’re using FrameMaker together with other resource-hungry applications like RoboHelp,…
Read MoreHow to Write About Changing Contexts in Procedural Task Steps
© Ugur Akinci In using software, the context changes frequently depending on the actions we take. For example, when we click a command button, a new window might open. Or when we select a specific option from a drop-down menu, the system may display a new dialog box in a new tab. A new window,…
Read MoreQ&A: "What is the difference Between a User Guide and a System Admin Guide?"
READER QUESTION: I’m working on a software product that has a GUI. Currently, we have a user guide and a system administration guide. The user guide mainly focuses on tasks that can be done thru the GUI; the admin guide mainly focuses on system maintenance and administration. However, there’s no distinguishing line between the two…
Read MoreHow to Write an Issue Case Study
A “case study” is similar to a “white paper” although white papers can be more technically detailed in nature. Simply put, they are both written to convince the reader that something (a product, a service, a company) works. That “something” could be a product/service, the story of how a product/service or method was implemented successfully,…
Read More