SUBSCRIBE TO MY NEWSLETTER

Sponsored content

Search results

Recording of Open Authoring -- Collaboration Across Disciplines presentation, by Ralph Squillace

by Tom Johnson on Nov 15, 2016 •
categories: api-doc podcasts

Ralph Squillace, a senior content engineer for the Microsoft Azure Infrastructure team based in San Francisco, California, recently gave a presentation to the STC Silicon Valley chapter (on November 14, 2016) on Open Authoring -- Collaboration Across Disciplines. In the presentation, Ralph talks about Microsoft's approach to scaling their authoring and publishing efforts across the company by embracing Markdown, Github, open source tools, and other processes that allowed everyone in the company to write and contribute to Azure's documentation.

Audio

Here’s the audio from Ralph’s presentation:

Listen to this presentation:

You can download the MP3 file, subscribe in iTunes, or listen with Stitcher.

The slides are here:

Open Authoring: Content Collaboration Across Disciplines with Ralph Squillace from Information Development World

Sponsored content

Presentation description

Here’s a description of the presentation:

At Microsoft, we are working to make technical content everyone’s responsibility. This presentation will focus on our efforts to increase collaboration across different disciplines at Microsoft by implementing open authoring strategies for areas like Azure using GitHub repos and Markdown. Our shift from a closed to open system enables our engineering, consulting, architecture, and support teams to actively engage and help drive up content satisfaction with customers. We’ll discuss our work to date, tools and best practices that are evolving to allow for collaboration, some of our plans for the future, as well as our lessons learned.

Key takeaways:

  • How collaboration across disciplines drives customer satisfaction
  • Open authoring strategies and tools that allow active collaboration across engineering, consulting, architecture, and support teams
  • Challenges of open authoring and cross-discipline content accountability
  • Best practices for sustainable collaboration

You can read more details from the event on the STC Silicon Valley site.

About Ralph Squillace

Ralph SquillaceRalph Squillace (pronounced "Squillachey") is a senior content engineer for the Microsoft Azure Infrastructure team based in San Francisco, California. He works directly with customers trying and breaking Azure, as well as writing, publishing, and teaching cloud and distributed architecture and devops development mainly on Linux workloads and working with Linux, Mac, and Windows. He’s responsible for much of the Azure CLI documentation, as well as Azure documentation for Docker, CoreOS, and various container orchestration systems such as Deis, Weave, Kubernetes, Mesos, and Docker’s machine, swarm, and compose for contained applications.

To learn more about Ralph, you can follow him on Twitter @ralph_squillace and Linkedin profile.

Buy me a coffeeBuy me a coffee
follow us in feedly

About Tom Johnson

Tom Johnson

I'm a technical writer / API doc specialist based in the Seattle area. In this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, visual communication, information architecture, writing techniques, plain language, tech comm careers, and more. Check out simplifying complexity and API documentation for some deep dives into these topics. If you're a technical writer and want to keep on top of the latest trends in the field, be sure to subscribe to email updates. You can also learn more about me or contact me.

Comments