Table of Contents

Contributing to Gobblin

This document will outline best practices for contributing Gobblin.

Code Contributions

We observe standard github practices for code contributions. Fork the repository and make your local changes on a feature branch, then open a pull request (PR). A committer will review the changes and merge it in once it is approved. For first time contributors to Gobblin, we do require that you fill out a one-time survey, so that we can identify and credit you properly in the future.

Documentation Contributions

To make changes to the documentation modify the files under gobblin-docs as you would any other version controlled file. All documentation is checked into GitHub, so the process for making documentation changes is similar to how code changes are made (creating Pull Requests). If one wants to see what the rendered documentation looks like they simply need to take the following steps:

  1. Install MkDocs locally, this page has directions on how to do so:
  2. Make sure you are in the top level directory for the Gobblin repo and execute mkdocs serve

These steps will start a local server to server the documentation, simply go to the URL show by the output of mkdocs serve and you should be able to see the documentation.

One the changes have been made and tested, create a PR and a committer will review and merge the documentation changes. Updates to the documentation page happen automatically everytime a commit is merged into the master branch; however, there may be a 10 to 15 minute delay before the changes actually show up.