This document will outline best practices for contributing Gobblin.
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:
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.