API Engineer

We want creating a ReadMe to be the first thing a developer does when it comes time to create an API. We don't want to just be documentation... we want ReadMe to be the entire UI for APIs.

ReadMe needs to start collecting documentation in the form of semantic metadata, rather than paragraphs of text. Swagger is emerging as the winner, so we'll start with building tooling around that. You should have a love for Swagger in concept, but a healthy wariness for it in practice: Swagger is confusing and tough to get started with, and we need to make it much easier for people to understand and implement.

We want to normalize APIs on the documentation/SDK layer. This means that anyone should be able to write their APIs however they want (API key as a header? sign requests with JWT? be x-www-form-urlencoded?), however all APIs on ReadMe should feel consistent to end users. We'll do this through a combination of things, including generating SDKs and building tooling around authentication.

Lastly, we want to start pushing our own philosophies... which you'll craft. APIs are simple, however people find infinite ways to complicate them. We'll never force anyone to do things a particular way, however going forward we want to start promoting best practices that will make working with ReadMe easier and better.

It's important that you love APIs, but focus on usability and ease-of-use rather than complexity.


Responsibilities

  • Making our "Try It Now" feature work like a charm in any situation
  • Auto-Generating code samples and SDKs in various programming languages
  • Allowing people to manage their API keys in ReadMe
  • Tackle the issue of authentication... it's confusing, and a huge barrier to entry for APIs
  • Work on leveraging what we know about the API and the user to custom-tailor documentation
  • Keep up to date with API technologies, and making that simple for everyone to understand and work with
  • Writing blog posts and (if you want!) speaking at conferences about APIs

Developer Bloggerremotepart-time

We’re looking for a developer who loves to write! We’re searching for someone who is good at explaining complex topics in a way that junior engineers would understand and senior developers would still find engaging. If you can impart wisdom, clarify something complex and crack a joke in the same sentence… you’re what we’re looking for.

The job will be a part-time remote job, and you can write as much or as little as you’d like. At first the medium will be blog posts, but we’d love to expand into content marketing sites, open source projects, and whatever else makes sense to help get the word out!

(Please not that we're only looking for actual developers who like to write... we already have non-technical blog writers!)


Potential Topics

  • API best practices
  • Microservices
  • Swagger (how, why, etc)
  • Reviews of developer tools
  • New feature announcements
  • In-depth guides on how to use our product
We're looking for an array of writers! We already have a blog that chugs along, so we're just looking for people to contribute to it... so we're flexible! We're just looking for opinionated people who want a platform to help people learn.

Enterprise Engineer

We power the developer portals for some of the biggest APIs and companies out there! And as the type of company that use ReadMe grows, we want to grow with them! We're looking for a product-focused Node developer who can work along side of our biggest and coolest customers to help them deliver an awesome user experience. You'll work on the engineering team, but will work closely with bizdev/growth/sales/etc.

On our growing engineering team everyone has ownership over major feature development. You'll have a strong voice in product planning, drive implementation and release of major features, and champion well-written and well-tested code.

You'll join a team where everyone is excited and supportive, we're always willing to pitch in and know that we do the best work together. We hope you join us!


Our Technology

  • Express
  • Mongo
  • Angular/React

Within 3 months you will...

  • Build and launch your first big feature
  • Become familiar with ReadMe's codebase and development patterns
  • Help to diagnose and solve bugs in production
  • Manage on-prem deployments of our codebase
  • Write documentation for your features
  • Be a bit creeped out by the number of owls in our office

Within 6 months you will...

  • Have made a visible, user-facing impact on the product
  • Own major feature areas
  • Decide when we can work with customers... and more importantly, when to say no
  • Be responsible for planning, scoping, and development within those areas

Within 12 months you will...

  • Help to hire and train new peers
  • Be a major voice in product direction
  • Act as an advocate for companies
  • Give in and develop an intense love of owls

Full-Stack Engineer - Remoteremotecontractor

We power the developer portals for some of the biggest APIs and companies out there! And as the type of company that use ReadMe grows, we want to grow with them. We're looking for a Node developer who can work along side of our biggest and coolest customers to help them deliver an awesome user experience. You'll work on the engineering team, but will work closely with bizdev/growth/sales/etc.

On our growing engineering team everyone has ownership over major feature development. You'll have a strong voice in product planning, drive implementation and release of major features, and champion well-written and well-tested code.

You'll join a team where everyone is excited and supportive, we're always willing to pitch in and know that we do the best work together. We hope you join us!


Our Technology

  • Express
  • Mongo
  • Angular/React

Within 3 months you will...

  • Build and launch your first big feature
  • Become familiar with ReadMe's codebase and development patterns
  • Help to diagnose and solve bugs in production
  • Manage on-prem deployments of our codebase
  • Write documentation for your features

Within 6 months you will...

  • Have made a visible, user-facing impact on the product
  • Own major feature areas
  • Decide when we can work with customers... and more importantly, when to say no
  • Be responsible for planning, scoping, and development within those areas

Within 12 months you will...

  • Help to hire and train new peers
  • Be a major voice in product direction
  • Act as an advocate for companies
  • Give in and develop an intense love of owls

React.js developer working on OpenAPI/Swagger stuff! (3-6 month contract)remotecontractor

We're looking for a React / frontend engineer to join us for 3-6 months (either part or full time, we're flexible!), to build out a new stand-alone component. We're looking to take Swagger / OpenAPI files (they're a spec for describing APIs; here's an example), and turn them into a UI. We kinda already do this, but OpenAPI Spec 3 is out and we want to switch to React anyway!

You'll probably want to be the type of person who enjoys the intricacies of RESTful APIs, although a deep knowledge isn't necessary. Be prepared to know way too much about OAuth 2 by the end!

If you're in San Francisco, we have a desk for you! If not, we'd love to fly you out to visit for a few days.

As developers, we spend most of our time either reading documentation or writing it. Documentation is the UX we use when interacting with a new API or programming language, yet it’s almost always relegated to an afterthought.

We don’t want to just make writing “good documentation” easier – we want to change what “good documentation” even means. Let’s replace paragraphs of text with simple onboarding flows, custom-tailored code examples, intuitive SDKs and interactive UIs. (Here's some things we're excited to work on.)

Developers are just like regular consumers. They like simple, beautiful, easy-to-use products, too.

We have a long way to go still. That's why we need you!

209 Kearny St #2, San Francisco, CA

Y Combinator Winter 2015

Seed funding (Raised over $1MM)


Competitive salary and significant equity

Good work/life balance. We don't work on weekends.

Quarterly product roadmap retreats at locations like Santa Cruz or Tahoe.

Unlimited days off. And don't even think of coming in on your birthday!

Ability to work from home a few days a week, if you're more productive that way.

Stay healthy! Paid monthly gym membership.

Full healthcare, vision and dental coverage; paid maternity / paternity leave.

Some Of Our Favorite Customers

ReadMe currently provides the developer experience for thousands of awesome companies.




Need beautiful documentation?

You may not be looking for a job, but everyone needs beautiful documentation!

Sign Up for ReadMe!