Tag Archives: API

Structured Writing is Essential for Developer Docs

Tom Johnson wrote a post recently in which he questioned the value of structured writing for developer documentation. Needless to say, I disagree. But Tom and I are not really at odds here. Rather, he means something different by “structured writing” than I do. Structured writing is about content quality, not publishing What I mean… Read More »

How Content Producers Get Collaboration Wrong

People assembling a jigsaw puzzle.

Content producers often find collaboration a hard slog. This is because they do it wrong. There are two fundamental ways you can collaborate. The first way is to enable everyone to contribute to the project by giving everybody access to everything and a means of communicating freely with everyone else on the team. I’ll call… Read More »