Katy DeCorah

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.

After missing a local pierogi pop up, I needed a better way to manage Instagram. I created Instagram RSS action that will generate an RSS feed from one or more public Instagram accounts.

To support my post Haiku 2018-2019, I created remark-lint-haiku to make sure that each haiku is in 5, 7, 5 syllable pattern. The linter uses syllable to count the syllables.

I found an old note that contained a project to write a haiku every day. My project started in December 2018 and ended promptly in January 2019. The themes included work, baking, and difficulty finding nice fabric.