Monthly Archives: April 2013

Wabi-Sabi Writing

My limited understanding of the Japanese concept of wabi-sabi is that it is an insight in which you can appreciate the beauty in the imperfect, impermanent, and incomplete. I don’t know about things you write, but imperfection, impermanence, and incompleteness … Continue reading

Posted in documentation, writing | 2 Comments

The Writing Life: Ernest Hemingway

“Since I had started to break down all my writing and get rid of all facility and try to make instead of describe, writing had been wonderful to do. But it was very difficult, and I did not know how … Continue reading

Posted in writing | Leave a comment

Semi-colon-oscopy

Stop using semi-colons in your technical documentation. You can stop reading now if you pledge to delete your semi-colons. If you don’t make such a pledge, read the rest of this riveting blog entry. I used to use semi-colons in … Continue reading

Posted in documentation, grammar, writing | Leave a comment

The Writing Life: Gertrude Stein

You will write if you will write without thinking of the result in terms of a result, but think of the writing in terms of discovery, which is to say that creation must take place between the pen and the … Continue reading

Posted in writing | Leave a comment

Reflections on Write the Docs Conference, 2013

I was pleasantly surprised by the Write the Docs conference. It cost about 10% of other documentation conferences and had nearly the same amount of great ideas. That’s a tremendous deal. Plus it was in Portland. In a McMenamins. With … Continue reading

Posted in documentation, writethedocs | Leave a comment

The Te of Piglet: The Writer in Agile

Traditionally, Agile development has used the terms chicken and pigs to delineate two types of people involved in the development process. The cliched Agile fable goes: A pig and a chicken are talking to each other. The chicken says, “Hey … Continue reading

Posted in agile, documentation, writing | Leave a comment

No Joke: Eucalyptus 3.2.2 Released on April 1st

We just released the latest version of our private and hybrid cloud software. This is a maintenance release, so there are no new features. But we fixed some storage issues, did security updates, and got various other things working more … Continue reading

Posted in documentation, Eucalyptus | Leave a comment