Going Forward

I wrote a post about moving on from being a technical writer, and I've definitely written some since then about programming and various side projects, but I haven't really done the kind of public reflection on this topic that I've done historically about, many other things. When I switched to a programming team, I knew some things about computers, and I was a decent Python programmer. The goal, then was to teach myself a second programming language (Go,) and learn how to make "real" software with other people, or on teams with other people.…

Keep reading

Works In Progress

I've posed about some of these projects before, and I used to regularly post little overviews of the things that I'm working on. But I've not done a lot of this recently. Time to do some back fill. I think it's probably good to take a step back from time to time and inventory and evaluate the priorities of various projects. Not to mention the fact that I usually say "I'm not really doing much these days," when this isn't really true.…

Keep reading

Get a Grip

I made another Go(lang) thing. Grip is a set of logging tools modeled on Go's standard logging system, with some additional (related) features, including: level-based logging, with the ability to set a minimum threshold to exclude log messages based on priority (i.e. debugging.) Error capture/logging, to log Go error objects. Error aggregation, in continue-on-error situations, where you want to perform a bunch of operations and then return any errors if any of them returned an error but don't want to return an error after the first operation fails.…

Keep reading

Said on the Train

I finished, on the train this week, reading Freud and the Non-European by Edward Said (on the recommendation of zmagg and it was, one of the better reading experiences I've had in a while. Said is brilliant, and clear and says really complex important hard things in a really clear and approachable style. He's also frustratingly correct, which isn't really a problem, but as an engaged and independent reader, I occasionally realize that the internal monologue of my response is an unintelligent "yep yep" chorus, and I feel like I've fallen down on the job of being a good reader.…

Keep reading

Have a Gimlet: A Go JSON/HTTP API Toolkit

Look folks, I made a thing! It's called gimlet, and it's a Go(lang) tool for making JSON/HTTP APIs (i.e. REST with JSON). Give it a whirl! It's actually even less a tool, and more of a toolkit or just "a place to put all of the annoying infrastructure that you'll inevitably need when you want to build an JSON/HTTP interface, but that have nothing to do what whatever your API/application does: routing, serializing and serializing JSON.…

Keep reading

A New Era

I'm writing the draft of this from an airplane bound for Ireland for a week of singing. I travel often: taking weekend jaunts to go to folk festivals, singing conventions, Morris dancing tours, and so forth, I don't really vacation often. I find travel and managing the logistics of being in unfamiliar places stressful, and my idea of a good time has a lot to do with sipping a cup of coffee [1] writing something, and reading a book.…

Keep reading

Style Chameleon

When I started my current job there were three major problems with the documentation: There was too much duplicated content, so it was difficult to know where to point people. Given that there were always multiple versions of the product in use, it was hard to figure out which paragraph refereed to which version, particularly as the product changed. Each page felt like it was written by someone else (it was!…

Keep reading