13 Sep 2021

The Power of Lists

Complete Enumeration

I often find it extremely helpful when people simply enumerate all of the options for something.

Here are some examples.

Reserved Keywords in TypeScript

In this GitHub issue, somebody asked what the list of reserved keywords in TypeScript were.

As a reply, someone simply posted a list:

I have used this list many times.

Grimgrains Ingredients and Recipes

Grimgrains, the Hundred Rabbits’ cooking blog, opens with a complete list of ingredients, followed by a complete list of recipes.

PyTorch Installation and Tensor Types

I’ve always been a huge fan of PyTorch’s installation instructions. It concisely but completely enumerates the set of installations. I never mind clicking through.

The list of tensor types available in PyTorch has exploded a bit—right now it still says there are ten tensor types, but by my counting, the table has seventeen rows—but I still like that they’re all there in one place.

Matplotlib Color Palettes

While ordinarily a bane of my existence,1 Matplotlib’s documentation shines on the page where they list—and render—all of the color palettes they have in the library.

Missing: pandas.Series.agg

This is a case where I wish there was a list, but there isn’t.

The documentation for pandas.Series.add says you can pass names of functions, but it’s not obvious which ones are valid. Can they live in the local namespace? Can they be builtins? Should they exist on the pandas.Series object?

  1. No shade on Matplotlib. You can tell it’s trying really hard, and I think graph-making is just actually really complicated to program. 

Monthly project and essay digest