Monthly Archives: March 2018

President’s Message – 2018-Q1

Finally, the weather seems to have turned to spring! I hope you are enjoying the longer daylight hours and milder temperatures.

\We have a few pieces of spring news. First, I am very happy to announce that Liz Miller has received the Distinguished Chapter Service Award from STC: “For your dedication, and your many contributions to the chapter, including hospitality manager, secretary, membership manager, and president.” Well-deserved! Congratulations, Liz!

Second, we are enjoying our new meeting location at the San Ramon Marriott. Lots of room, and the food has been great. Come and join us soon!

We're enjoying our new meeting place at the San Ramon Marriott

San Ramon Marriott

Also, two of our members (Liz Fraley and Gale Naylor) are presenting at the STC Summit, May 20-23 in Orlando, FL. You can still register for the Summit, and also come to our June 7 meeting, when we will have a Summit Recap panel.

Finally, our Q1 2018 Newsletter is live, thanks to Liz Miller and new member, Dan Littman!

Enjoy the rest of the newsletter and I hope to see you soon!

Planting a SEED to STEM careers

SEED, a program designed to help promising disadvantaged youth launch science careers, is seeking mentoring help from technical communicators.

The California Section of the American Chemical Society’s Summer Experience for the Economically Disadvantaged (SEED) program  is:

  • A nation-wide program run by the American Chemical Society
  • A chemistry-oriented, hands-on research internship program
  • Focused on low-income high school students who are paid for participating over 1-2 summers
  • Full-time work for 9 weeks under the supervision of scientist mentors in industry, academia, and government labs

Dr. Elaine Yamaguchi is the retired but tireless Coordinator for the California Section of SEED, which is the second largest program in the US, thanks to her volunteer efforts for the past 35 years.

In 2017, five CA Section students won college scholarships after completing their chemistry internships, more than any of the nation’s other SEED programs.

Now, interested members of northern California STC chapters have an opportunity to directly increase the number of student scholarships by helping a SEED student  write compellingly about his or her summer internship in the application form. 

SEED welcomes any STC member who is willing to provide editorial support in the late fall for two important scholarship application answers. Making 350 words in two boxes sing is no great effort for us. But the outcome of a couple hours and a few emails with a SEED student could result in a life-changing transformation for a budding young chemist’s college prospects.

The SEED-STC partnership was instigated by past EBSTC president Liz Miller, who has been supporting the Chevron-sponsored activities behind Elaine’s program since 2015. “Providing writing and administrative support is extremely gratifying to me because I know I’m helping open doors for every student who participates,” she says. “It’s impossible not to be inspired by Elaine’s passion and dedication. Creating an opportunity for STC to contribute seemed like a natural fit.”

Learn more about the STC partnership in this short presentation prepared by Liz, Planting a SEED to STEM career. Once you are inspired, contact Elaine and CC Liz Miller.

Maturing Your Information Development Processes – 5 April 2018 [Meeting]

What makes an industry leader in the area of information development? What practices are critical to the department’s success and predictors of the quality of content produced?

For over 20 years, Comtech and the Center for Information Development Management (CIDM) have partnered with leading information development organizations to assess and monitor the characteristics that define process maturity in the creation of technical content.

Tools, technology, and user expectations continue to evolve the content we produce. Similarly, the processes followed while creating that content should also adapt.

To respond to changing demands, we must leave behind our old concepts of information development management and adopt new definitions of process maturity.

Based on continuing conversations with leading information development organizations, this presentation examines key performance indicators for 10 characteristics that define mature organizations in today’s market.

About Our Speaker

Dawn StevensDawn Stevens is the president of Comtech Services and Director of CIDM. With 28 years of experience, including 17 years at Comtech, Dawn has practical experience in virtually every role within a documentation and training department, including project management, instructional design, writing, editing, and multimedia programming. With both engineering and technical communication degrees, Dawn combines a solid technical foundation with strong writing and design skills to identify and remove the challenges her clients face in producing usable, technical information and training.

Meeting Logistics

Date: Thursday, 5 April 2018.

Meeting Recap

by Dan Littman

Structured-content methodologies, in particular DITA, have spread inexorably through the tech–comm world over recent decades. At the EBSTC’s April 5 get-together we heard from a street–smart DITA consultant about how the methodology affects not just technical documentation, but also how companies organize themselves and operate. Our guest speaker was Dawn Stevens, who last year took over at Comtech Services, the influential Denver–based DITA consultancy started by JoAnn Hackos.

Dawn prefaced her presentation with some remarks about the changing purpose of writing technical documentation. Structured authoring, and in particular DITA, emerged as a way to “future–proof” information so it can be easily adapted for new communication technologies. Dawn points out that DITA comes with a taxonomy attached that makes it ideal for incorporation into the latest communication technology: artificial intelligence information systems. The consequence is that the technical books and procedural guides of yore are being eclipsed by small chunks of self–assembling information—a necessary transition as the audience for information moves from humans to machines.

We technical communicators have to adapt to what that demands, which includes:

  • new tools, such as XML and CMSes
  • new platforms, such as dynamic and social media, and of course mobile devices
  • new technologies, such as video and augmented reality
  • new responsibilities, such as planning taxonomies and designing for user experience

All those changes have knock-on effects for people who use our information, which in turn requires us to adapt in other ways as well. As an example, Dawn cites studies that show people average a 60 percent retention rate for what we read on paper, but only 18 percent for information on a smartphone screen—which drives an increasingly “just–in–time” approach to seeking information.

Well, after making those points, Dawn didn’t talk so much about DITA itself, concentrating more on how organizations change to make room for DITA. Her presentation, entitled “Maturing Process Maturity” (see her card deck here), zeroed in on 10 key business considerations and practices that determine whether organizations can reap the benefits of structured authoring. In no particular order, the 10 factors are:

  • Organizational structure
  • Hiring and training
  • Collaboration
  • User awareness
  • Budgeting
  • Planning
  • Estimating, scheduling and tracking
  • Information design
  • Quality assurance
  • Change management

None of these practices are really new (except perhaps information design), but the challenges they present and the ways they’re executed are changing. Some requirements have clearly become easier to meet due simply to better technology. In the case of collaboration, for example, everything from email and network servers to video–conferencing and content–management systems allow tech–comm departments to work fluidly together. And when it comes to QA, there are tools available that incorporate the tech-comm department’s style guide and keep writers attuned to established procedures.

Even so, Dawn has concluded that most tech-comm departments still perform poorly on the 19th–century–sounding requirement to estimate, schedule and track their work. Budgeting also trips up its share of sincere efforts. And she finds that organizations whose functioning on many of the 10 factors is at mediocre to middling levels (on her informal five-level scale) are doomed to run aground on any attempt at deploying DITA in their operations.

At our next meeting, on Thursday May 3, EBSTC chapter president Gale Naylor will describe her journey from volunteer on an open-source project to a paid career gig at a major Silicon Valley company. It’s an interesting story, and it should be especially useful to anyone trying to find a niche in the tech–writing world. Mark your calendar for an evening at our new meeting room in the San Ramon Marriott’s Bishop Grill.