make all dexy

See "Why The World Is Ready For Dexy" and "Dexy and Literate Documentation" as well as the technical writing section section of the tychoish wiki for some background to this post. The brief synopsis: dexy is a new tool for handling the process of the documentation work flow between writing and publication. It takes snippets of code, and bits of documentation and passes these atomic chunks through filters to generate technical articles, manuals, and other high quality resources.…

Keep reading

Rule By Community

When Oracle acquired Sun Microsystems, there was a lot of (warranted) concern for what would happen to the Open Source projects that Sun started, supported, and championed. Though the acquisition began years ago, now, I think we're still in the process of figuring out how all of this filters down. The concern, largely grows from the fact that while Sun licensed a lot of work under free and permissive terms, and was an active contributor to communities, Sun (and now Oracle) remains the ultimate owner of that work moving forward.…

Keep reading

Knitting Pattern Complexity

I've been writing a series of terribly self indulgent posts about thinking about creative projects as work and about the habit and rhythm that I've been using to get work done, even under adverse circumstances. As exciting as the increased blogging and progress on fiction projects is, I'm just as excited about figuring out how to squeeze in knitting and reading time into my days. And not to overshadow the importance of figuring out how to make the best of my time, but the other major factor in my return to knitting is that I finally finished the plain sweater that I'd been working on for 7 months (or so) and got to cast on a sweater with a two-color pattern, in a nifty yarn, and a pattern that's strongly reminiscent of my favorite sweater.…

Keep reading

Documentation isn't Content

See "Why The World Is Ready For Dexy" and "Dexy and Literate Documentation" as well as the technical writing section section of the tychoish wiki for some background to this post. Let's establish some basics. Content, as I think of it, in the context of new/web/digital media, is all of the stuff we read and right on the web. Documentation are those texts which supports the use and creation of technical tools, and explains technical concepts.…

Keep reading

Specific Rhythms

One part of finding momentum and working to dedicate a bit of energy to some projects that I've been neglecting for a while. I've written a bit about finding the rhythm of my current routine, I've not written about what I'm actually doing. I hope this isn't too boring for words. Since the end of July, I've chosen to undertake a 2 hour each-way commute. Thankfully it's all by rail, so the thought is that while I might not have a lot of time at home, I have more than enough time to get work done, of any sort, on the train.…

Keep reading

Infrastructure and Place

I've been playing around with writing a story or a few stories about transpiration infrastructure, I spend a lot of time on trains. And I in a part of the world where there's a lot of transportation infrastructure, but most of it is nearly 100 years old. So while it's nice that there are trains, it's also apparent that the trains are designed to serve a reality which is radically different from the one that people today occupy.…

Keep reading

Art Work

I've written between 100 and 300 words on this novel that I've been working on for two and a half years, for the past two weeks. After too many months of writing much less than this, and I'm pretty sure that it's been much longer since I've been able to write this regularly (regardless of length) on a fiction project. This feels amazing, and for the first time in forever, I feel like a real writer.…

Keep reading