The Open Source Story — Open Sourcing RudderStack Blog and Docs

It’s all About Open Source

Joe Worrall, Director of Open Source and Developer Advocacy at New Relic, describes the dynamics behind the power of building contributor-centric systems:

“Contributors don’t give to the cause. They are a part of it.”

RudderStack is an open-source customer data pipeline tool for developers. Being open source is a tag we wear with pride, so much so that we recently partnered with GitHub for GitHub Sponsors for Companies. We value the developer community that works hard to build and support open-source projects. In a recent blog, we explained why RudderStack directly compensates developers for their contributions to our project. This post discusses why and how we open-sourced our content and took the next step in our open source journey.

Why we Open Sourced our Blog and Docs

We want developers to share their ideas, thoughts, and findings while working with RudderStack, customer data, and data in general. We want to learn about the data stacks you are building, problems you are solving, and solutions you are creating. Blogs, tutorials, and even case studies are great ways to share that knowledge. In short, we want you to contribute!

Our Previous Blog Infrastructure

From a site performance and version-control standpoint, though, it’s less straightforward than more modern tooling. Also, to allow contribution, you have to use some sort of plugin (like User Submitted Posts), a less-than-ideal experience for developers, and opens up your dashboard to outside users.

All-in-all, building an open-source, version-controlled blog that enables developers to create content and submit it via pull requests easily is a cumbersome and tricky process on WordPress.

Open Source Frameworks Options for our Blog

Why we Picked Gatsby

Here’s why we chose it:

  • Writing content in Gatsby is simple and developer-friendly. It uses Markdown for formatting. It just takes two plugins to set it up (gatsby-source-filesystem and gatsby-transformer-remark).
  • Integration with GitHub Pages is simple, which was a priority for us.
  • Gatsby has a rich library of plugins, which you can use for extending and introducing additional functionalities (in fact, through GitHub Sponsors, we had a RudderStack plugin made!)
  • Implementing Gatsby is relatively straightforward in most cases. You can check their docs to see how to get started with Gatsby.js.
  • Gatsby is super high performance, meaning speedy page load times.
  • Gatsby allows creating an interactive experience for the readers.
  • A vast modern web development community contributes to it.

Wait, What About the Docs?

We are Open Source now!

In fact, developers have already started contributing to our documentation. Recently, Benedikt from the Userlist team created the docs for the Userlist destination for RudderStack (see the pull request here). They also built the Userlist integration, submitted a pull request, and it is now live on our platform! This is the beauty of open source!

How to Contribute

  • Visit RudderStack Blog to contribute to blogs or RudderStack Docs for docs..
  • If you wish to add a new blog/doc, click on Create new file or Upload files as shown in the following diagram.
  • Also, to suggest changes to an existing file, go to the file and select Edit this file.
  • Once you make the changes, Click on Propose changes.
  • Once your Pull Request is created, we will review the changes you’ve made.
  • If everything looks okay, our team will accept it (or edit to make it reader-friendly), and Voilà! Your changes will reflect on the pages.

Sign up for Free and Start Sending Data

This blog was originally published at https://rudderstack.com/blog/the-open-source-story-open-sourcing-rudderstack-blog-and-docs

RudderStack is the CDP for developers. - https://rudderstack.com