STC San Diego

  • Home
  • Attend Meetings
    • Events Calendar
    • Meeting Recap
    • Past Presentations
  • Chapter News
    • Professional Development
    • Technical Communication
    • Star Volunteer
  • Grow Professionally
    • Webinars
    • Education
    • Conferences
    • STC Publications
    • Organizations and User Groups
  • Job Seekers
    • Resume Review Service
    • Job Boards
    • Job Finding Tips
    • Agencies
    • Career Evaluation Tests
    • 2018-2019 STC Salary Database
  • About STC San Diego
    • Contact STC San Diego
    • Council Members and Volunteers
    • Community Member Spotlight
    • What is Technical Communication?
  • Join STC
    • Become a Volunteer
    • STC’s Mission and Vision
    • Become a Corporate Sponsor
  • Subscribe

02/27/2019 By Matt Sullivan

Achieving Content Nirvana with FrameMaker

Content nirvana: A state of content bliss, free from the repetitive effort and suffering associated with digital publishing and ad hoc formatting. Structure content with Framemaker

How to get there

The first step on this path is to understand how you spend your time. In particular, where you are you doing time other than content creation and editing? That means accounting for the time you spend managing pagination, numbering, referencing, and text formatting.

If you’re interested in evaluating your own tech comm workflow, regardless of your current system or software, see my free Intro to FrameMaker online course. The first section of the course includes a self-assessment worksheet. This helps you understand the actual cost of various parts of your workflow. For a list of other options, see the end of this post.

Nirvana, or the complete removal of wheel spinning and tail chasing, may not be possible. I have been able to recover 80% of that wasted effort (time spent away from actual content creation and editing). To save time I removed the impediments to content creation, and made content creators happier with what they do. As result, organizations are more willing to invest in additional projects that improve the speed and quality of production.

I gave a webinar on Achieving Content Nirvana for STC-SD on February 26, 2019. A recording is available for $5 or free to those who already registered.

I broke up the 1.25 hour session into several sections. You can use this outline as a general table of contents for the webinar recording itself.

Structure content with Framemaker — Why you should care about structure

Structured content brings with it inherent benefits. Moving to a structured system can be somewhat expensive for small orgs. Payback on the initial investment may take up to a year or more.

However, when working in a solid structured environment you can expect to see economies of scale with respect to:

  • Accuracy (especially related to maintaining consistent formatting and organization)
  • Localization (translation into other languages)
  • Compliance (contract requirements)
  • SEO/Search (in internal systems, Google, or both)

The higher your annual expense in these areas, the faster you should migrate to structure. Begin structure with FrameMaker. FrameMaker works seamlessly with both structured and unstructured (paragraph-based) content.

Here’s an example of a structured document. See how you can follow the document’s content in the structure view, which helps you conform to the content model.

Online Help Output

Publish to online help with FrameMaker linked to RoboHelp. However, FrameMaker contains essentially the same publishing engine. This engine allows you to output directly from FrameMaker’s Publish pod. You can skip the step of maintaining and updating a RoboHelp project for this purpose.

Benefits of direct help output from FrameMaker include:

  • Straightforward content editing using FrameMaker’s familiar interface
  • Straightforward formatting of both PDF output and help output
  • Fully customizable CSS if you want to go beyond the options in FrameMaker’s CSS GUI.
  • Solid support for direct output of CSH (See techcommtools.com/csh for details)

Perfect PDF

FrameMaker has always produced fantastic PDF output, complete with bookmarks, embedded rich media, and automatically inserted interactive links. With FrameMaker 2019, there are a number of improvements to an already great system, including:

  • 64-bit processing
  • Intuitive setup via Publish pod
  • Control over options

Sophisticated template management

Structure content with Framemaker . In case you didn’t already know, template management and a template-based workflow are perhaps the biggest reasons for using FrameMaker. Simply put, combining FrameMaker best practices with a well-designed template lets you easily and effectively:

  • Separate content from formatting
  • Easily control thousands of pages if needed

Scriptable environment

Scripts and plugins are my favorite FrameMaker labor savers. I almost always invest in a few scripts when working with a client on a workflow overhaul or a conversion from one format to another.

For those who enjoy writing code, the interface is straightforward. For the rest of us, there is a robust community of folks that can help with existing tools. They can quickly create scripts to reduce the amount of handwork needed for tedious tasks.

My rule of thumb: If you expect a task to take more than 3 hours, you should consider having a script written instead.

Where to go from here

If you liked this post or enjoyed listening to the webinar, check out the following resources (all available on techcommtools.com) to help you move along that path to content nirvana!

Intro to FrameMaker course (Free)

Generously underwritten by Adobe, this course introduces you to FrameMaker and gives you what you might need to pick up and start making edits to existing FrameMaker documents. To register for the course, see the link on the FrameMaker 2019 welcome screen, or visit https://techcomm.tools/fm2019intro

Advanced Authoring online course

This course moves beyond the basic information in the Intro course and shows you how to create and edit sophisticated content.

See the course syllabus and other details at FrameMaker – Advanced Authoring

Template Design Workshop

This invaluable course begins by showing you how to evaluate your content and branding requirements and takes you all the way through producing a set of working templates.

See the course syllabus and other details at Framemaker – Template Design Workshop

The course:

  • Explains how to format content for one or many authors
  • Steps through creating all the formats needed for your template
  • Optimal time for this online course is 2 weeks to a month

FrameMaker – Working with Content reference book

In addition to this FrameMaker 2017 book, editions for FrameMaker 11 and FrameMaker 2015 are also available.

Structured Authoring workbook/course

Learn to work with an existing content model in a structured environment

Structured EDD Dev workbook/course

Learn to format a content model so that authors can easily and accurately create conforming structured content

On-Demand Online Meetings (including recordings)

See mattrsullivan.youcanbook.me if you need anywhere from 30 minutes to a few hours of help working out your options or solving issues in anything I do professionally.

Filed Under: Meeting Recap, XML Tagged With: FrameMaker, structure content, structured authoring, technical writing

Search This Site

Upcoming Events

  • STC-SD Networking Program
    10/06/2023
  • Support STC San Diego

    Amazon donates to STC San Diego when you shop at smile.amazon.com.

    Join the Mailing List

    You don't have to be a member of STC to stay informed with STC San Diego happenings. Just sign up for our free newsletter.

    Recent Posts

    • Get That Interview! Beat the Applicant Tracking System 07/20/2021
    • Call for Candidates! 04/28/2021
    • Beating the Applicant Tracking System and Getting Hired 08/16/2020
    • The users don’t need our content? So, what do they want? 07/19/2020
    • 2020 STC Summit, Online 04/21/2020

    Archives

    Recent Posts

    • Get That Interview! Beat the Applicant Tracking System 07/20/2021
    • Call for Candidates! 04/28/2021
    • Beating the Applicant Tracking System and Getting Hired 08/16/2020
    • The users don’t need our content? So, what do they want? 07/19/2020
    • 2020 STC Summit, Online 04/21/2020

    Upcoming Events

  • STC-SD Networking Program
    • 10/06/2023
  • Connect with us

    • Facebook
    • LinkedIn
    • Twitter
    • YouTube

    Support STC-San Diego

    STC-San Diego is a 501(c)3 charitable organization. Help support us by donating through PayPal.

    Donate By Going Shopping!

    • Contact STC San Diego
    • Join the Mailing List
    • Job Search Tips
    • Job Listings on LinkedIn

    Copyright © 2023 · STC San Diego