Someone started selling a book titled “Postgres for Ladies” on Amazon (now removed).

On the plus side, it received some well-deserved snark in the reviews that was both amusing AND on point:

But when my wife wanted to learn to use [Postgres], she just couldn’t wrap her head around it. Personally, I think it was due to stress at work; computational modeling of disease transmission takes a lot out of a girl.

I’ve created a database with all of our finances, for example. It includes our expenses, and every month she adds in her income from work. She’s even managed to automate the process of removing $.23 from every dollar she earns, just like her employer does.

On the minus side, presumably someone thought the book was a genuinely good idea :(

You wrote some code. It uses a library, libfoo.

libfoo is not a thing in stasis, a little island of perfection birthed into an ideal of perfect form and function.

libfoo has a version, because libfoo changes as features are added and bugs are fixed.

You do not “depend on libfoo”, you depend on some specific version of libfoo, with its behaviour at that time.

Younger-me believed a bunch of classic “naïve engineer fallacies”, like “marketing is a waste of time, it’s all about technical superiority”. One of them was “Cover letters are a waste of time! They should be able to tell my suitability from my CV alone!” (somehow I still believed this despite having a very short CV).

Younger-me was wrong, very wrong.

Send a cover letter. Please.

This is a long-form version of a talk I was invited to give at PyDiff (the Cardiff Python meetup) last year The audience was an exciting range of people, from professional software engineers, to mathematicians who’d written their first Python a few weeks prior.

Tools for better Python

There are things that will help you write better Python that are not Python-specific, like practice, good posture, documentation and empathy. These will help you be better at almost everything you do.

There are Python-specific things that will help you write better Python. However you may find them less useful in other areas of life…

There was some code, it looked a bit like this:

from django.utils import timezone

start_date = timezone.datetime(2015, 1, 1)

Django recommends that you use, for example, django.utils.timezone.now to ensure you always get “the right now” (i.e. timezone-aware). So you might, as with the code example above, extrapolate that timezone.datetime(2015, 1, 1) will give you a timezone-aware “1st of January 2015” datetime object.

This is not what happens. You get a naïve datetime object. Why?

When I write reStructuredText or Markdown or similar, I add linebreaks after commas and full stops, rather than at some sort of pre-determined / arbitrary line wrap point.

One of my favourite things that’s come out of the UK’s Government Digital Service is the Government Service Design Manual.

It manages to provide an incredible amount of guidance and resources for anyone involved in “digital delivery”, while remaining implementation-agnostic and succinct.

Through circumstance and history, there’s a bunch of tasks and procedures for which I’m either the only one on my team who knows how to do them, or at least the local expert who does them most frequently.

For the sake of my team’s autonomy, resilience, and ability to evolve these processes, it’s important that this knowledge and experience isn’t confined to just me.

So here’s what I generally do to change that:

“As $role I want $desire so that $benefit”

I’m growing to love the idea of user stories. A simple short sentence or two capturing someone’s need, providing context to indicate their motivation, and usually specifying little in the way of implementation details.

(Having little experience of pets, and none of anonymous herds of cattle, perhaps “like blood cells, not like limbs” is a better analogy…)

This is a pretty common adage among people working at any kind of scale. I just wish it was more generally accepted.

Reboot your servers often. Destroy and rebuild them often. Poke them, prod them, ensure that your services continue.