Category Archives: documentation

Whining: the other side of advocacy

One of the arts of any craft is learning how to deal with colleagues. And part of this is learning the give-and-take nature of relationships. I love the passion that comes from advocating a position strongly held. It’s good not … Continue reading

Posted in documentation | Leave a comment

Using Coltrane changes in documentation

In jazz, there’s a common method to get from one place in a progression to another. It’s called the two-five device (really it’s ii-V, but I want to convey that that it’s pronounced “two-five”). In music theory, the five chord wants … Continue reading

Posted in documentation | 2 Comments

Ba-dee-ya, publishing tomorrow

In the spirit of wabi-sabi, I’m thinking about using “ba-dee-ya” as a placeholder for my unfinished content. I have some deadlines that I won’t make and, rather than commenting out entire sections of text, I think I’ll include what I … Continue reading

Posted in documentation | Leave a comment

Context and confusion and twins

I’m a big fan of Every Page is Page One design. One of the tenets of an EPPO topic is that it sets the context for the content within that topic. This way readers don’t have to rely on our … Continue reading

Posted in documentation, EPPO | Leave a comment

Going beyond a shared understanding…sort of

As a writer working in the software field, I often hear a lot of ideas that aren’t expressed very well. Well, they’re expressed in specifications or in code. They’re just not expressed in actual communication that someone who doesn’t read … Continue reading

Posted in documentation | Leave a comment

Goodbye cloud. Hello big data. Oh yeah: nice to see you again, cloud

This week I started my new gig at Cloudera. I’m quite excited about the opportunity. Although, I already miss my colleagues and friends at Eucalyptus. It’s a big change for me. For the first time in seven years, I won’t … Continue reading

Posted in documentation | Leave a comment

Thanks for Nothing: Help that Sucks

I love Amazon. I used to work there for years. Most of their documentation is really good. However, I found the following help for downloading Kindle for Mac to be . . . well . . . please refer to … Continue reading

Posted in documentation | Leave a comment