[Peninsula] "Structured Authoring to Set Your Content Free" at Genesys

Ed Jamer, Barry Grenon

Ed Jamer, Senior Technical Writer, Genesys Information Experience
Barry Grenon, Senior Manager, Genesys Information Experience

How structured authoring, leveraging open source tools, can help your Pubs group grow from being a bottleneck—with complicated toolchains preventing non-writers from contributing—to a service organization that can provide all sorts of content across the organization, including docs-as-code and converged content straddling techcom and marcom, with true single-source-of-truth guiding the overall design of the system.

Focusing on two case studies, this talk will highlight some of the benefits of a pure open source, structured-authoring approach.
As a service group:
Content experts define the forms and data structures used by all contributors, to enforce consistency of both content and metadata.
Enable single-source-of-truth content repositories that other groups can pull content from, via REST APIs. In other words, support for a “headless CMS” approach to content re-use between websites (everyone can still own their own websites).
As a writing group:
Your own technical writing group becomes just another group to service.
Treat your content like a database, for maximum flexibility of re-use. The structure itself provides the keys from which you can build, sort, link, collate, and automate content.
Open source allows for rapid prototyping: the “build and show” model for successful projects, versus the “propose and hope” model.

We are people who care about making the reader experience awesome by delivering excellent documentation. We are writers, developers, designers, learning professionals, and documentation enthusiasts. Come to our meetup and strategize how to make documentation great, and meet others in the Bay Area who care about documentation.

** To see events for all the local WTD groups (San Francisco, East Bay, and South Bay/Peninsula), click Meetups (https://www.meetup.com/Write-the-Docs....

** Access our GitHub repo, https://github.com/San-Francisco-Writ... .

** Read the Write the Docs Code of Conduct at http://www.writethedocs.org/code-of-c... .

Produced by NDV:    / @nextdayvideo  

documentation

Tue Apr 2 19:00:00 2019 at Genesys