How to apply agile processes to manage your life’s projects

The challenge of keeping up

At the upcoming TC Camp, during a brief 5-minute feud activity, Marta Rauch and I are going to provide our perspectives on the following question:

How can I keep up with all the tools, technologies, info and other stuff to stay marketable? What happened to the good old days (Read more...)

Back to Top | Comments Off on How to apply agile processes to manage your life’s projects

Documenting long JSON objects

Most API documentation explains the parameters available for each endpoint. Usually the parameters are passed in the endpoint URL or in the request body.

I'm now documenting an endpoint in a project at work that includes about 200 lines of code in a JSON object passed in the request body. There are various levels of (Read more...)

Back to Top | Comments Off on Documenting long JSON objects

The problem with adopting “bleeding-edge” tools

What are the bleeding-edge tools?

In a recent discussion on the Techw-l listserv, an academic was looking to find advice about the "bleeding edge" trends in help authoring tools. Academics want to prepare students to succeed in the job market once they graduate, and since academics usually aren't focused on tools, this person was (Read more...)

Back to Top | Comments Off on The problem with adopting “bleeding-edge” tools

Spec-driven Development with RAML — presentation by Michael Stowe to STC Silicon Valley chapter

Slides

Here are Michael's slides:

RAML for Tech Writers from Michael Stowe

Audio recording

Here's the audio recording:

You can also download the MP3 file directly.

(Next time we'll record the video too.)

Spec-driven development presentation description

Here's a description of the presentation and a little bit about Michael:

Spec Driven Development isn’t just changing (Read more...)

Back to Top | Comments Off on Spec-driven Development with RAML — presentation by Michael Stowe to STC Silicon Valley chapter

First video for API documentation course — your feedback?

Here's the first video for my API documentation course.

Since I'm planning to make a lot more videos somewhat like this, I want to make sure I'm doing them right.

My Setup

Here are a few details of my setup:

  • iPhone 5 camera mounted on tripod
  • Audio recorded separately at 48Khz using Zoom recorder (Read more...)
Back to Top | Comments Off on First video for API documentation course — your feedback?

Other Stuff