December Adventure

I’ve always been impressed with the folks who manage to do National Novel Writing Month (and Writing Month after the “official” NaNoWriMo org self-destructed), completing a whole novel in a month, or even just taking a serious crack at it.

but I don’t know that a novel is really my jam. A few times I’d considered doing a December of Documentation, as I’ve got two largish (and several smaller) documentation-like projects I’d like to undertake anyway.

Separately, I really like the idea behind Advent of Code, but the two times I’ve taken a crack at it I got a wek or two in before running out of steam for the “daily” aspect (and as the challenges get more complex, catching up gets less practical). I like the direction of the changes AoC made this year and was considering taking another run at it, but the timing with some other things around the beginning of December made it not feel like the year for that.

Then Eli posted a reminder about something he’d started a few years earlier, December Adventure. I’d seen this last year and watched some neat stuff come of it, but it had slipped my mind as a thing to consider doing. When he mentioned it, it seemed like a good fit. Especially this year, I really like the emphasis on “low key”, a little bit of a genler encouragement. And I had a built-in project for the first few days. It seemed like a good fit.

So. Here’s My December ADVENTure log.

2025

Day 9

I belatedly got this log posted. Released my current draft of slideshow, my weird tool for creating nice-looking presentations on Plan 9 using the native draw functions. I’ve got a decent “howto”-style writeup, but a proper man page is still pending; hopefully this evening.

Day 8

I spent an hour or so in the evening fixing up my lab report on fixing my Synolgoy. This one’s been sitting for a few weeks, waiting on a push to finish it, so I think I can call this December Adventure a net win already. :-)

Day 6 & 7

Unintentional break day. I didn’t plan well enough around the weekend and family to preserve space for this. Notes for next weekend to do better on that.

Day 5

Intentional break day.

Day 4

More work on the talk, mostly the tour (although, as expected, it’s impossible to resist tweaking the rest), right up until ~30 minutes before the talk.

I think the talk went really well (aside from a distressing number of “um"s and "uh"s); I feel like I got across what I wanted, people seemed to really enjoy it, and I got a good amout of engaged questions (including about things I’d wanted to include but cut for time). It was a fun group who asked some really good, engaged questions.

As suggested by the organizer, I’d planned for about 45 minutes; as he’d suggested, after questions we ended almost exactly an hour and a half after we started. That’s an impressive read on his group on his part.

The talk is now available on YouTube.

Day 3

More work on the talk. I’m mostly happy with the ‘slideshow’ part, although I expect I’ll keep tweaking it. As of the afternoon, I’m mostly working on the slides for the tour. This feels harder in some ways: there’s so much neat stuff to show. Doing it right in acme feels increasingly like the right choice, since it lets me show parts of the system implicitly, as I’m explicitly showing other parts. In retrospect, that fact makes me wonder if it would’ve been better to do the whole talk in acme, especially since I’m intentionally keeping the ‘slideshow’ part relatively simple, but it is nice to be able to “builds” on slides (and the font situation is much better if I run it under plan9port).

Day 2

More work on the Plan 9 talk. I realized today what I really want is a two-part structure, with ‘slideshow’ providing most of the structure and explanation, with a tour of the system part-way through (so I can actually show people things instead of just talking about them). I’m going to do the tour part in Acme directly, using Ori’s (I think?) ‘Slide’ scripts. That will let me stick example commands to run directly in the “slides” and execute them right from there, demonstrating a nice bit of Acme.

Day 1

Last month, I was invited to give a talk at the monthly Portland Linux/Unix Users' Group meeting about Plan 9. Which is wonderful… but that’s real soon now and I should actually write it. Great! Built-in starter project! The talk’s on the 4th and I expect to be working on it these first 4 days of December.

I’m writing the talk in slideshow, my goofy “write your presentation in C” project I put together for my IWP9 talk this past May. I like it, but it is not the most efficient way to do this sort of thing. Getting started, I realized it’d be pretty easy to define a small language and awk processor that would allow me to write in a much more natural format for the slides and auto-generate at least the most common slide formats, but I’m resisting the urge to spend time on that right now so I can finish the actual content in time for it to be ready for Thursday.

I’m starting from a bunch of hand-written notes and the original intro paper, plus references from Charles and Ori about earlier talks, as well as some other suggestions.

I was advised by the organizer to plan for about 45 minutes and that questions from the group usually fill it out to about an hour and a half, so that’s my target.