The Open Source Story – Open Sourcing RudderStack Blog and Docs | RudderStack

neub9
By neub9
5 Min Read

It’s all About Open Source

Open source is a vital component of today’s software development. Looking back, the impact has been profound. For example, Python became the language best-suited for machine learning due to the contributions from the open-source community. In fact, the immense size of the open-source community that works tirelessly on Python led to Google open-sourcing TensorFlow.

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, an open-source customer data pipeline tool for developers, has proudly partnered with GitHub for GitHub Sponsors for Companies. We value the hard work of the developer community that builds and supports open-source projects. In a recent blog, we explained why RudderStack directly compensates developers for their contributions to our project, and discussed why and how we open-sourced our content to broaden our open source journey.

Why we Open Sourced our Blog and Docs

Bringing more voices to the table increases the quality and value of our content, both in thought leadership and technical documentation. 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

We used WordPress for our blog before we decided to open source it, as it is open source and great for its simplicity, SEO settings, advertising, and flexible themes. However, from a site performance and version-control standpoint, it’s less straightforward than more modern tooling. Our decision to switch to an open-source framework came from the need to create a version-controlled system that enabled developers to contribute easily, a cumbersome and tricky process on WordPress.

Open Source Frameworks Options for our Blog

We had multiple well-supported and fully-featured frameworks to choose from when we decided to open-source our blog and docs. The options we considered included Ghost, Jekyll, Hugo, Nanoc, and Gatsby. Each tool has its pros and cons, so the best tool for you is the one that fulfills your requirements.

Why we Picked Gatsby

We picked Gatsby.js as the framework for open-sourcing our content. Writing content in Gatsby is simple and developer-friendly, it uses Markdown for formatting, integrates with GitHub Pages, has a rich library of plugins, and is super high performance. Furthermore, it allows creating an interactive experience for the readers and is supported by a vast modern web development community.

Wait, What About the Docs?

Our docs still run on Gitbook but are now open-sourced so that others can contribute. We are currently exploring other open-source frameworks like Slate that will give us more flexibility and better telemetry.

We are Open Source now!

The RudderStack Blog and Docs are now open source. We’re excited about contributions from the RudderStack community and beyond. Developers have already started contributing to our documentation, and it’s the beauty of open source!

How to Contribute

Contributing to RudderStack is simple! Visit the 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. Suggest changes to an existing file by going to the file and selecting Edit this file. Once changes are made, Click on Propose changes. Once your Pull Request is created, we will review the changes you’ve made, and if everything looks okay, our team will accept it (or make it reader-friendly), and Voilà! Your changes will reflect on the pages.

Sign up for Free and Start Sending Data

Test out our event stream, ELT, and reverse-ETL pipelines. Use our HTTP source to send data in less than 5 minutes, or install one of our 12 SDKs in your website or app. Get started.

Share This Article
Leave a comment

Leave a Reply

Your email address will not be published. Required fields are marked *