Weekly Round-up: Styling Developer Documentation, Empathy, Problem Words, Auditors, and More

Weekly Round-up: Styling Developer Documentation, Empathy, Problem Words, Auditors, and More


Here's K15t Software's 30th weekly social web round-up for technical writers, information architects, and content strategists – sharing 150+ links.
 

This week's top story from the Atlassian Developers blog: “A New Viewport in Confluence"

Atlassian-Styling-Developer-Documentation-with-Scroll-Viewport-K15t-Software.png


A New Viewport in Confluence

Travis Smith of Atlassian explains how they mixed static webpages and developer documentation written and managed in Confluence, using our add-on  Scroll Viewport: "An excellent way to display Confluence content with custom skins"  Read more

atlassian-developer-docs-viewport.jpeg

Why Don’t You Have a Writer in Your UX Team?

A new theme is emerging in the user experience (UX) world: Empathy, or putting humanity into technology. Because writers deal with emotions all the time, Georgina Laidlaw comes to the conclusion: "Your UX team needs writers."  Read more

Problem Words that Give Writers Trouble

The Acrolinx blog has compiled a list of problem words that writers tend to get wrong.  Part 1 starts with "Affect and Effect", while  part 2 covers problem words like "Fewer and Less" – including explanations and examples.  Read more

Natural Born Auditors

In regulated industries, a technical writer's work is subject to several audits. Dan Goldstein has found parallels between auditors and writers – e.g. digging deep for information: "If you enjoy it as a writer, you’ll enjoy it as an auditor."  Read more

TOCTOC

Are you still writing your documentation in a word processor? Here's someone who wants to say something to you:

Error rendering Tweet https://twitter.com/FuRuftTut/status/534410165081370625. Please try again in 1 minute(s).



Did you miss something in this collection? What blew your mind this week?

Please leave a comment if you've found other techcomm-related news on the web! Or send us an email to info@k15t.com.


Share this article
Sync Jira Without Apps
Sync Jira Without Apps

🧪 How would Sheldon Cooper collaborate on Jira? 🤔 He’d use Backbone Issue Sync’s remote license, of course!

Reset Cookies

The following services will be reset and deactivated for you.

  • Hyvor Talk:
    We're using Hyvor Talk as a comment tool. Hyvor Talk sets a local storage when activated. By clicking "Disable all services" you're no longer able to post or read comments on our website until accepting the service again.
  • YouTube:
    We're using YouTube to embed video into our website. YouTube sets cookies when activated. By clicking "Disable all services" you're no longer able to watch our embedded videos on the website until accepting the service again.

By clicking "Disable all services" all cookies and local storages related to the services will be removed. Before using them on our website again, you need to accept them.