Collection: Detailed instructions

17 Dec 2007, 13:19 p.m.

Powerpoint Karaoke: Best Practices

Danny O'Brien mentioned this concept and tried it out at a conference several months ago. So Leonard and I playtested it at Backup Thanksgiving (photos) at our apartment, with several of our friends. One of …

Read More
25 Aug 2010, 2:35 a.m.

How To Get And Deal With A Lawyer

At least one friend of mine was generally unsure how one finds and works with a lawyer to get help with, say, government paperwork, or employment contract review. The "How to get a lawyer" entry …

Read More
10 Jun 2013, 9:57 a.m.

Yes You Should Have Business Cards

Left-justify your name and web address and email address -- no title necessary -- in a legible font. Get the perforated cardstock and do it on a home printer, or get a local copy shop …

Read More
05 Dec 2013, 7:51 a.m.

Fisher-Price's My First Twitter Bot

On Sunday I wrote my first Twitter bot, with a bit of help from Leonard. (A Hacker School colleague inferred, understandably, that Leonard and I just write Twitter bots on the weekend, to relax.) Then …

Read More
01 May 2014, 10:11 a.m.

Better Q&A Sessions

If you were designing an interactive experience where people got to ask an expert questions about what she'd just taught them, what would you aim to achieve? How would you structure it? I imagine you …

Read More
26 Sep 2014, 19:17 p.m.

The Continuing Adventures (Transitioning From Intern To Volunteer)

By now dozens of women have stepped into open source via Outreach Program for Women, a paid internship program administered by the GNOME Foundation. I recently asked several of them whether they had been able …

Read More
08 Oct 2014, 8:01 a.m.

How I made a tidepool: Implementing the Friendly Space Policy for Wikimedia Foundation technical events

Back when I worked at the Wikimedia Foundation, I used the Ada Initiative's anti-harassment policy as a template and turned it into the Friendly Space Policy covering tech events run by WMF. I offer you …

Read More
18 Nov 2014, 15:21 p.m.

Using Beautiful Soup, Pystache, and Lunr.js for an Archival Site

My third week of my 2014 Hacker School batch, I decided to take on a project that I'd originally thought about doing a year before, during my first go at HS. Between April 2005 and …

Read More
15 Dec 2014, 11:06 a.m.

A Code Review Group

I'm interested in piloting a peer code review group, structured like a writer's group. So next month I'm starting one out in New York City, starting with Hacker School alumni and participants, and I figured …

Read More
02 Jan 2015, 16:12 p.m.

Hacking on Mailman using Launchpad and Bazaar

I am starting to hack on Mailman, per my plan for early 2015 -- and along the way, I'm also learning how to use Launchpad and Bazaar. Mailman To quote maintainer Barry Warsaw's architectural overview, …

Read More
21 Mar 2015, 16:14 p.m.

I Invite First-Timers To WisCon

I have been to WisCon three times (2009, 2010, 2011) and I am going again this year, yay! If you enjoy my writing, you might like WisCon, and -- especially if you've never tried it …

Read More
22 Apr 2015, 12:14 p.m.

How Knowledge Workers Can Learn More About Open Source Tools They Use

Yesterday I spent an hour teaching a woman whose nonprofit wants improvements to their current Drupal setup, especially around content approval workflow and localization. She wanted to understand more about how Drupal works so that …

Read More
24 Apr 2015, 15:26 p.m.

Technothriller Book Review Partially In The Form Of A Python Exercise

I am glad I read Hackster: The Revolution Begins..., a technothriller by Sankalp Kohli and Paritosh Yadav taking place in modern-day India. It's plotty and passionate and tense, and it's about Indians to whom India …

Read More
09 Aug 2015, 22:52 p.m.

How To Improve Bus Factor In Your Open Source Project

Someone in one of my communities was wondering whether we ought to build a new automated tool to give little tasks to newcomers and thus help them turn into future maintainers. I have edited my …

Read More
16 Sep 2015, 13:03 p.m.

Software In Person

In February, while coworking at the Open Internet Tools Project, I got to talking with Gus Andrews about face-to-face tech events. Specifically, when distributed people who make software together have a chance to get together …

Read More
29 Mar 2016, 20:01 p.m.

Tips To Increase Your Conference Talk Acceptance Rate

This year I submitted talks to several tech conferences and got a higher acceptance rate than I had been used to. For instance, this year I will speak for the first time at OSCON and …

Read More
04 Aug 2016, 15:51 p.m.

Advice on Starting And Running A New Open Source Project

Recently, a couple of programmers asked me for advice on starting and running a new open source project. So, here are some thoughts, assuming you're already a programmer, you haven't led a team before, and …

Read More
26 Sep 2016, 9:33 a.m.

iCalendar Munging with Python 3, Requests, ics.py, and Beautiful Soup

Leonard and I love seeing movies at the Museum of the Moving Image. Every few months we look at the calendar of upcoming films and decide what we'd possibly like to see together, and put …

Read More
04 Apr 2017, 12:37 p.m.

How to Teach And Include Volunteers who Write Poor Patches

You help run an open source software community, and you've successfully signalled that you're open to new contributors, including people who aren't professional software engineers. And you've already got an easy developer setup process and …

Read More
26 Jan 2018, 17:28 p.m.

Preserving Threading In Google Group or Mailman Mailing List Replies with Thunderbird

Have you ever wanted to reply to a mailing list post that wasn't in your inbox? I had that problem yesterday; here's how I fixed it. Context: I'm the project manager for Warehouse, the software …

Read More
03 Oct 2018, 15:13 p.m.

A Reasonably Fast Way To Construct A Writing Portfolio

Someone in my network wanted guidance in building a professional (often software-related) writing portfolio for the first time -- they want to give other people a portfolio of work they've already done, so that those …

Read More
27 Feb 2019, 8:01 a.m.

GSoC/Outreachy Mentoring Orgs: Consider Giving Applicants English Tutoring

Google Summer of Code just announced the 207 mentoring organizations (open source projects seeking participants) for this year's round, and Outreachy's 9 mentoring orgs also announced open internship projects. This blog post is directed at …

Read More
04 Nov 2019, 12:56 p.m.

Art of Python Seeking Organizers for 2020

In May, I chaired "The Art of Python", a festival of arts about programming that took place at PyCon North America. People presented short plays, monologues, songs, and a video remix that explored how it …

Read More
27 Apr 2020, 18:00 p.m.

Remote Sprint Tips

Every year, many developers of Python (the language itself, not just stuff written in Python) get together for a sprint. This year it will probably be virtual. How should that work? I offered to share …

Read More
26 Aug 2020, 14:01 p.m.

Imaginary Book Club, and How To Run It

"Imaginary Book Club" is an improv-type session that's fun to run at a scifi/fantasy convention. It's a panel where each participant "reviews" a book that does not exist, and the other people riff on that. …

Read More
01 Sep 2020, 13:45 p.m.

Remedial Skills In Open-To-The-Public Working Groups

I'm talking in this post about wikis, political clubs, open source projects, fanvidding exchanges -- any groups where people try to work together and are open to the public. "No, what's that?" Some people joining …

Read More
08 Sep 2020, 22:13 p.m.

Breaking Release Bottlenecks -- What Changeset Can Do

I did some volunteer work earlier this year, helping rejuvenate pipenv (a command-line tool that some people use to help handle Python packages they make and use). Here's what I did, how long it took, …

Read More
01 Feb 2021, 11:59 a.m.

Three Ways I Exercise In My Apartment

My mental and physical health are much better if I can exercise, to the point of getting sweaty, for at least 20 minutes every day. The forms of exercise I most enjoy (hiking, biking for …

Read More
02 Mar 2021, 18:55 p.m.

Getting My First COVID-19 Vaccine In New York City

On Saturday night I received my first vaccination dose against COVID-19. I've had minimal side effects and the appointment went very smoothly. Here's a longish post about eligibility in New York, booking the appointment, and …

Read More
18 Mar 2021, 9:49 a.m.

Podguess -- A Little Guessing Game

I came up with this game and Leonard and I have been enjoying it the last few days, so here it is for you. I just came up with the name "podguess" which does not …

Read More
07 Jun 2021, 17:28 p.m.

Sidestepping the PR Bottleneck: Four Non-Dev Ways To Support Your Upstreams

This is the textual version of my June 7 2021 online talk at Upstream Live: "Sidestepping the PR Bottleneck: Four Non-Dev Ways To Support Your Upstreams", 23 minutes. Video is now up. Intro Hi, I’m …

Read More
27 Sep 2021, 13:04 p.m.

Prep For Shortages And Delays -- Meds, ID Cards, Books, Etc.

The global supply chain is dealing with a lot of shortages and delays, and there's no sign it's going to get better anytime soon. (Some explanations: thread, thread, NYT piece.) People are figuring out how …

Read More
02 May 2022, 16:00 p.m.

"I want to start contributing to open source": My (Current) Advice

Want to become a better programmer? Join the Recurse Center! In the virtual PyCon hallway track, a newcomer to the industry said he'd like to get into contributing to open source, and asked for my …

Read More
05 May 2022, 13:00 p.m.

PDFtk, qpdf, And Dealing With Password-Protected PDFs

I slice, dice, and transform documents often enough that I rely frequently on pandoc and pdftk. I often use pandoc to turn Markdown, HTML, wiki syntax, reStructuredText, etc. into each other or into LibreOffice, MS …

Read More
22 Dec 2022, 15:10 p.m.

Speech-to-text with Whisper: How I Use It & Why

Whisper, from OpenAI, is a new open source tool that "approaches human level robustness and accuracy on English speech recognition"; "Moreover, it enables transcription in multiple languages, as well as translation from those languages into …

Read More
16 Jun 2023, 1:10 a.m.

My Current Approach To Reducing My COVID Risk

I follow a few main principles to reduce my risk of catching COVID-19:

  1. Avoiding sharing unfiltered air with people outside my household
  2. Noticing how safe I am and raising precautions accordingly
  3. Focusing on protecting myself over protecting unmasked people (in general)
  4. Spending money

In this post, I detail those principles as well as my specific protocols (masking, ventilation, self-testing, and so on), including links to examples and product vendors.

Read More
29 Mar 2023, 11:30 a.m.

Dyeing My Hair

I recently bleached and dyed my hair at home, and I really enjoyed the end result. A few people expressed curiosity, and I will probably want to refer to the process later, so here's a …

Read More
13 Apr 2023, 9:30 a.m.

Your First PyCon, But Not Your First Convention

Someone I know just decided to come to this year's PyCon US in person and asked me:It's my first PyCon. Are there any tricks or landmines I should know about? I assume that the standard …

Read More