Substrate

#jason-brennan
Maps, books, and code
Maps, books, and code
You could imagine a world where cartography never incorporated drawings of territories, and instead relied solely on written descriptions of land. “To the west is a mountainous range, with several large rivers emptying to a gulf in the south.” In such a world, there would no doubt be practised experts, capable of envisioning in their minds the described area. But these written maps would clearly suffer from a lack of depictions.
·nearthespeedoflight.com·
Maps, books, and code
Pull Requests Volume 1: Writing a Great Pull Request
Pull Requests Volume 1: Writing a Great Pull Request
The real benefit of doing this is it gives your team a chance to learn something. It gives anyone on your team who’s reviewing the code a chance to learn about the issue you faced, how you figured it out, and how you implemented the feature or bugfix. Yes, all of that is in the code itself, but here you’ve just provided a natural language paragraph explaining it. You’ve now created a little artifact the team can refer to. In a good description, you need to tell the reviewer: What the pull request does. How to test it. Any notes or caveats.
·nearthespeedoflight.com·
Pull Requests Volume 1: Writing a Great Pull Request
Stating the Obvious
Stating the Obvious
That’s the sort of stuff I often write about, too. I’m not writing groundbreaking stuff, but I am trying to make some connections I (and you) might not have otherwise made. It might sound obvious when you read it, but my hope is by writing it down, by giving it a name, whatever obvious thing I write about becomes just a little bit more tangible.
·nearthespeedoflight.com·
Stating the Obvious
Programming is Performance Art
Programming is Performance Art
“The main way to prevent software from rotting, it seems, is to maintain it: update it so that it continues to work as the platforms supporting them change underneath. In this sense, though, it’s not the same software you started with, as it’s continuously changing.”
·nearthespeedoflight.com·
Programming is Performance Art