Published January 27, 2026
Jay and I have been working on Render Engine a fair amount in the last couple of weeks. One of the things we're working on now is improving the consistency of the code styling throughout the project. To that end we've made a style guide to help new contributors. One of the things we included was that Markdown lines should be limited to, at most, 120 characters to make code reviews for Markdown changes more readable.
Having made the decision that we're going to add that character limit to the style guide we need to actually enforce it. But it looks like there are a fair number of places we need to change. And one of the issues is long links. Jay came up with the idea that we have descriptions and links on the bottom. TIL that this is a thing you can do in Markdown - Reference Style Links. This solves something that has been a pet peeve of mine - lines that are way too long because of a link.
So from now on, I'll use these reference style links and have a cleaner and more readable document for all the stuff I do in Markdown.
(I wrote this in Obsidian on my iPad and I have no idea how long the lines are. I just toss line breaks in where I think they need to go.)