Katy DeCorah

The books, music, and recipes I enjoyed this summer.

Like our markdown linters, all Mapbox documentation repositories use a shared ESLint configuration. Our configuration covers everything from enforcing React best practices to improving accessibility, including:

The books, music, and recipes I enjoyed this spring.

A muddy and beautiful descent to Barberville Falls.

Do you track searches with no results on your site? To the Mapbox documentation team, it’s an interesting dataset. We can learn what the user wants, but cannot find, and then turn those failed searches into improvements.

Yesterday I wrote about the markdown linters we use at Mapbox. Our other test suite focuses on language and asserts the Mapbox documentation styleguide. Our copyeditor is a fork of alex, which helps you find gender favoring, polarizing, race related, religion inconsiderate, or other unequal phrasing in text.

At Mapbox, we write a majority of documentation in markdown. We have a suite of markdown linters to help us stay consistent and improve the quality of our documentation.

Since moving to the documentation team at Mapbox at the end of 2018, I’ve helped solved a lot of fun problems, but haven’t written about them. Let’s change that.

I have been on a GitHub actions kick with read-action and instagram-rss-action. Most recently, I created bookmark-action that saves a URL along with the page’s metadata to a YAML file. I created this to track all the new recipes I tried so far this year.

The books, music, and recipes I enjoyed this winter.