July 4, 2021
A shared ESLint configuration
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:
June 12, 2021
Improve documentation with failed searches
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.
June 6, 2021
Copyeditor on commit
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.
June 5, 2021
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.
April 10, 2021
Monitor 404s with Sentry
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.
March 27, 2021
Save your bookmarks with GitHub actions
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.