{"id":2992,"date":"2025-01-07T20:08:32","date_gmt":"2025-01-08T02:08:32","guid":{"rendered":"https:\/\/readme.com\/resources\/?p=2992"},"modified":"2025-01-07T20:08:33","modified_gmt":"2025-01-08T02:08:33","slug":"i-hated-writing-documentation-so-i-founded-a-company","status":"publish","type":"post","link":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company","title":{"rendered":"I Hated Writing Documentation so I Founded a Company"},"content":{"rendered":"\n<p>People tell you to start a company around doing what you love. I founded a company to stop doing what I hated\u2014documentation.<\/p>\n\n\n\n<p>I started my career as a developer at Mozilla working with PHP, before rising through the ranks to Python. After I decided to leave Mozilla, I did a lot of freelance development work for startups, big businesses, and even VCs.<\/p>\n\n\n\n<p>And whether I was working for a company like Mozilla, or I was working with a solo developer on an app, I always found myself knee-deep in terrible documentation. While most developers didn&#8217;t give this inconvenience much thought, it drove me insane, and I needed to do something about it.<\/p>\n\n\n\n<p>Fast forward five years, and here I am at my own documentation-made-easy startup, ReadMe. Yet whenever I tell people about my business, I&nbsp;<em>still<\/em>&nbsp;always hear: \u201cWow, you must loooove documentation.\u201d Not at all. Here&#8217;s how I turned my biggest gripe into a business.<\/p>\n\n\n\n<p><strong>The Gripes of a Backend Developer<\/strong><\/p>\n\n\n\n<p>Y Combinator co-founder Paul Graham points out that a lot of startups are born because of&nbsp;<a href=\"http:\/\/www.paulgraham.com\/schlep.html?ref=blog.readme.com\">schlep blindness<\/a>. Basically, most people accept \u201cschleps\u201d\u2014tedious tasks like filing or processing payments\u2014as necessary evils. The inconvenience fades into the background and the problem gets ignored. If you can identify a big enough problem that everyone else overlooks, you&#8217;ve got a great starting point for a company.<\/p>\n\n\n\n<p>Terrible documentation was my \u201cschlep.\u201d<\/p>\n\n\n\n<p>I&#8217;ve felt like API documentation was super important for a product&#8217;s success\u2014even back in 2010. APIs opened up what you built to the rest of the software ecosystem. It let other developers plug in your product into whatever they were working on. And the more people who rely on your API to build their own software, the more indispensable your product.<\/p>\n\n\n\n<p>Good documentation meant the difference between other people using your API or ignoring it completely, but most people treated it as an afterthought. There was no industry standard for the best way to document, so everywhere you turned you&#8217;d find different half-hearted attempts at it.<\/p>\n\n\n\n<p>Documentation was often:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Out-of-date.<\/strong>\u00a0Developers would throw together a slapdash docs.theirstartup.com page and never touch it again. As a result you&#8217;d get cryptic documentation that you&#8217;d have to sift through to find the relevant bits, and then try and figure out how to make sense of those.<\/li>\n\n\n\n<li><strong>Incomplete explanations.<\/strong>\u00a0Developers who read API documentation come from different coding backgrounds with different levels of experience. What comes across as obvious to the maker isn&#8217;t at all obvious to most consumers.<\/li>\n\n\n\n<li><strong>Disorganized.<\/strong>\u00a0Those developers that did put a lot of time and thought into their documentation often came up with an overwhelming online manual. As a user, you wouldn&#8217;t know where to start, and figuring out the relevant information for your use-case was near impossible. So even a valiant effort at documentation often falls short of its ultimate goal.<\/li>\n<\/ul>\n\n\n\n<p>But you could hardly blame the makers. The task of documenting your API and explaining every single use for it was a&nbsp;<em>huge<\/em>&nbsp;undertaking, since good documentation takes months or even years to build out. On one hand, the utility of a API was obvious and great documentation seemed necessary, on the other, the task of crafting great documentation was too labor-intensive.<\/p>\n\n\n\n<p>In my first few years as a developer, I had found the schlep that would inspire me to one day build my own product.<\/p>\n\n\n\n<p><strong>How to get rejected from YC<\/strong><\/p>\n\n\n\n<p>DocHub was my first attempt to fix documentation. It was essentially a template for documentation that included a nav bar, versioning, and places for users to comment. And even though it was enough to land me and my friend Matt Garner an interview at Y Combinator, it wasn&#8217;t enough to seal the deal.<\/p>\n\n\n\n<p>Most people apply to YC with a company and a business model. They typically have a product with some traction, and an inkling of what to do with it. All we had was an idea, a terrible name, and slogan: \u201cWriting good documentation is hard. But it doesn&#8217;t have to be. Really!\u201d But when we landed the interview, it was my first sign of public validation. Landing the interview with YC was a significant sign that people might care about what we were making.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png\" alt=\"\"\/><\/figure>\n<\/div>\n\n\n<p>The VCs didn&#8217;t even let us finish our pitch. They interrupted saying that what we were offering was a consulting service, not a product. In VC speak, that means we didn&#8217;t have an idea that could scale. We floundered through the rest of the demo, even though the die had been cast. Within a few weeks we received our rejection letter.<\/p>\n\n\n\n<p>The thing with a schlep is that the problem that seems so obvious to you isn&#8217;t obvious to other people. Our failure to get into Y Combinator wasn&#8217;t because we had a bad idea. It would just take much more than a week-old prototype to get people to see past their schlep blindness.<\/p>\n\n\n\n<p><strong>A Market for ReadMe<\/strong><\/p>\n\n\n\n<p>The market wasn&#8217;t right for my tool when I was first rejected from YC, but two years later everything had changed.<\/p>\n\n\n\n<p>The rise of API-first companies proved how valuable an API is to other businesses. Apps could now build call functionality via Twilio or credit card processing functionality via Stripe quickly and easily. And because these companies didn&#8217;t have a consumer-facing side, good documentation took the precedence. Crystal-clear documentation was what allowed everyone from lone developers to multi-million dollar companies to be able to use them.<\/p>\n\n\n\n<p>These API first companies essentially created a market for a product like the one I had been trying to build for almost five years. So now that I had better developer chops, a sense of the market, and unshakable conviction in my idea, I finally built ReadMe. Here&#8217;s what I came up with for my the first version:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>A custom domain.<\/strong>\u00a0So that developers didn&#8217;t have to start their docs from scratch.<\/li>\n\n\n\n<li><strong>HTML\/CSS pre-built layout.<\/strong>\u00a0Developers could type markdown within the layout, and add in different types of modules for things like code snippets, or warnings. They could focus on the content, and not the web design.<\/li>\n\n\n\n<li><strong>API explorer.<\/strong>\u00a0A tool that let users sandbox their calls from the documentation to get an idea of how the API works.<\/li>\n\n\n\n<li><strong>API key generator.<\/strong>\u00a0A tool that saves developers the trouble of having to sift through the documentation to learn how to get their key.<\/li>\n<\/ul>\n\n\n\n<p>It was a platform that equipped developers with tools that saved the makers a lot of explaining, and saved users a lot of searching and navigating. And I didn&#8217;t have to prove that this was useful to anyone anymore. All I would have to say was Stripe-like documentation, and people immediately recognized the value in ReadMe.<\/p>\n\n\n\n<p>ProductHunt posted our page up months before we had planned on launching. A week later we launched on Hacker News. And between these two, we got over 5,000 signups and became profitable. Oh, and the second time we applied to YC\u2014this time with a real product and some big customers\u2014we got in.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>People tell you to start a company around doing what you love. I founded a company to stop doing what I hated\u2014documentation. I started my career as a developer at Mozilla working with PHP, before rising through the ranks to Python. After I decided to leave Mozilla, I did a lot of freelance development work [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","inline_featured_image":false,"footnotes":""},"categories":[22],"tags":[],"ppma_author":[55],"class_list":["post-2992","post","type-post","status-publish","format-standard","hentry","category-api-tips"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.0 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>From Frustration to Innovation: The Birth of ReadMe<\/title>\n<meta name=\"description\" content=\"Explore how Gregory Koberger transformed his aversion to documentation into ReadMe, revolutionizing how developers create and use docs.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"From Frustration to Innovation: The Birth of ReadMe\" \/>\n<meta property=\"og:description\" content=\"Explore how Gregory Koberger transformed his aversion to documentation into ReadMe, revolutionizing how developers create and use docs.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company\" \/>\n<meta property=\"og:site_name\" content=\"ReadMe: Resource Library\" \/>\n<meta property=\"article:published_time\" content=\"2025-01-08T02:08:32+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-01-08T02:08:33+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png\" \/>\n<meta name=\"author\" content=\"Gregory Koberger\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Miche Nickolaisen\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company\",\"url\":\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company\",\"name\":\"From Frustration to Innovation: The Birth of ReadMe\",\"isPartOf\":{\"@id\":\"https:\/\/readme.com\/resources\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#primaryimage\"},\"image\":{\"@id\":\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#primaryimage\"},\"thumbnailUrl\":\"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png\",\"datePublished\":\"2025-01-08T02:08:32+00:00\",\"dateModified\":\"2025-01-08T02:08:33+00:00\",\"author\":{\"@id\":\"https:\/\/readme.com\/resources\/#\/schema\/person\/770bcc036178743133b5ba515195981b\"},\"description\":\"Explore how Gregory Koberger transformed his aversion to documentation into ReadMe, revolutionizing how developers create and use docs.\",\"breadcrumb\":{\"@id\":\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#primaryimage\",\"url\":\"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png\",\"contentUrl\":\"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/readme.com\/resources\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"I Hated Writing Documentation so I Founded a Company\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/readme.com\/resources\/#website\",\"url\":\"https:\/\/readme.com\/resources\/\",\"name\":\"ReadMe: Resource Library\",\"description\":\"Making API documentation better for everyone\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/readme.com\/resources\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/readme.com\/resources\/#\/schema\/person\/770bcc036178743133b5ba515195981b\",\"name\":\"Miche Nickolaisen\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/readme.com\/resources\/#\/schema\/person\/image\/a24e32f88df84934c107cef6fa8d3223\",\"url\":\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/IMG_7151-scaled-e1718387764646.jpg\",\"contentUrl\":\"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/IMG_7151-scaled-e1718387764646.jpg\",\"caption\":\"Miche Nickolaisen\"},\"description\":\"An Austin resident since 2009, Miche grew up in rural southwestern Missouri. When not working on ReadMe's content marketing, you can find them doing a number of hobbies, including (but not limited to) bouldering, martial arts, playing tabletop RPGs and\/or video games, bullet journaling, and making art. They live with a large menagerie of indoor pets and a smaller (outdoor) menagerie of feral cats they take care of (sometimes including a few possums and raccoons, just for good measure).\",\"url\":\"https:\/\/readme.com\/resources\/author\/miche\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"From Frustration to Innovation: The Birth of ReadMe","description":"Explore how Gregory Koberger transformed his aversion to documentation into ReadMe, revolutionizing how developers create and use docs.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company","og_locale":"en_US","og_type":"article","og_title":"From Frustration to Innovation: The Birth of ReadMe","og_description":"Explore how Gregory Koberger transformed his aversion to documentation into ReadMe, revolutionizing how developers create and use docs.","og_url":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company","og_site_name":"ReadMe: Resource Library","article_published_time":"2025-01-08T02:08:32+00:00","article_modified_time":"2025-01-08T02:08:33+00:00","og_image":[{"url":"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png"}],"author":"Gregory Koberger","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Miche Nickolaisen","Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company","url":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company","name":"From Frustration to Innovation: The Birth of ReadMe","isPartOf":{"@id":"https:\/\/readme.com\/resources\/#website"},"primaryImageOfPage":{"@id":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#primaryimage"},"image":{"@id":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#primaryimage"},"thumbnailUrl":"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png","datePublished":"2025-01-08T02:08:32+00:00","dateModified":"2025-01-08T02:08:33+00:00","author":{"@id":"https:\/\/readme.com\/resources\/#\/schema\/person\/770bcc036178743133b5ba515195981b"},"description":"Explore how Gregory Koberger transformed his aversion to documentation into ReadMe, revolutionizing how developers create and use docs.","breadcrumb":{"@id":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#primaryimage","url":"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png","contentUrl":"https:\/\/blog.readme.com\/content\/images\/2016\/08\/ihatedocs-1.png"},{"@type":"BreadcrumbList","@id":"https:\/\/readme.com\/resources\/i-hated-writing-documentation-so-i-founded-a-company#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/readme.com\/resources\/"},{"@type":"ListItem","position":2,"name":"I Hated Writing Documentation so I Founded a Company"}]},{"@type":"WebSite","@id":"https:\/\/readme.com\/resources\/#website","url":"https:\/\/readme.com\/resources\/","name":"ReadMe: Resource Library","description":"Making API documentation better for everyone","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/readme.com\/resources\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/readme.com\/resources\/#\/schema\/person\/770bcc036178743133b5ba515195981b","name":"Miche Nickolaisen","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/readme.com\/resources\/#\/schema\/person\/image\/a24e32f88df84934c107cef6fa8d3223","url":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/IMG_7151-scaled-e1718387764646.jpg","contentUrl":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/IMG_7151-scaled-e1718387764646.jpg","caption":"Miche Nickolaisen"},"description":"An Austin resident since 2009, Miche grew up in rural southwestern Missouri. When not working on ReadMe's content marketing, you can find them doing a number of hobbies, including (but not limited to) bouldering, martial arts, playing tabletop RPGs and\/or video games, bullet journaling, and making art. They live with a large menagerie of indoor pets and a smaller (outdoor) menagerie of feral cats they take care of (sometimes including a few possums and raccoons, just for good measure).","url":"https:\/\/readme.com\/resources\/author\/miche"}]}},"authors":[{"term_id":55,"user_id":0,"is_guest":1,"slug":"greg-koberger","display_name":"Gregory Koberger","avatar_url":{"url":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/lSQSlvk3_400x400.jpeg","url2x":"https:\/\/readme.com\/resources\/wp-content\/uploads\/2024\/06\/lSQSlvk3_400x400.jpeg"},"first_name":"Gregory","last_name":"Koberger","position":"Founder, CEO","slogan":"","description":"Greg hails from the lovely town of Schaghticoke in upstate New York. After attending RIT he made the move to San Francisco where he worked for Mozilla and freelanced for a bunch of startups. He founded ReadMe after building docs sites for most of them. You can find him drinking coffee or obsessively competing for Swarm mayorships."}],"_links":{"self":[{"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/posts\/2992","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/comments?post=2992"}],"version-history":[{"count":0,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/posts\/2992\/revisions"}],"wp:attachment":[{"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/media?parent=2992"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/categories?post=2992"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/tags?post=2992"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/readme.com\/resources\/wp-json\/wp\/v2\/ppma_author?post=2992"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}