Over the last 12 months, my tutorial on building a gatsby+airtable powered documentation site has been getting a slow but steady trickle of reads. People are excited about this technology!
So it’s finally time to post an update. 12 months have gone by but it’s clear this tech is here to stay.
But not just for documentation sites… I’m using it for full-featured, responsive landing pages, storefronts and more. Here is what this stack gives me:
81 percent of women and 43 percent of men report having experienced some form of sexual harassment during their lifetime. 
Voices are louder than ever, demanding change. With recent viral movements, celebrity admissions and high-profile accusations, we are more familiar with shocking statistics like these, and we are starting to talk.
Unfortunately, abstract numbers and aggregated statistics aren’t enough to change behavior. To solve complex societal problems like harassment, we need to get our communities engaged and focused. We need to connect with each other on a personal level.
And how can we do that? It starts by connecting…
It’s a simple, but powerful concept: asking a bunch of people to mark stuff on a map.
We call it “collaborative and crowd-sourced mapping”, or “crowd-mapping” but there are many other names:
What do these methods all have in common? They all involve asking people “where”. They are enabled by widespread access to the internet, web-mapping technology, rising technical literacy, and social media.
Let’s talk about what we mean by crowd-sourced mapping, and why we think it’s so cool.
It’s important to understand the main…
In 2017, I helped run a pilot project asking the citizens of Karlsruhe, Germany to map their wants and needs with regards to bicycle infrastructure.
I was amazed at the quality of the contributions and comments our project received — though building and marketing the web-app proved much more difficult than anticipated. I looked at every tool on the market, and found all of them far too expensive, confusing or inflexible.
What is collaborative mapping? Also called crowd-mapping, public participation GIS, and many other names — collaborative mapping is the simple act of working together to mark stuff on a…
Building and maintaining documentation pages, help sections, or knowledge bases can be a daunting task. We wanted the canvis.app knowledge base to fit a few criteria: fast and lightweight, search-optimized, affordable to host, portable, branded and well-designed, and most importantly: easy to organize and edit between non-technical team members.
I finally found something that checks all these boxes, was a breeze to build, and didn’t require a single SaaS subscription!
In this tutorial we will create a simple documentation website comprised of a table of contents, sections, and pages.
See the final code here: