Developer Guide

Edit this page Submit an issue

Submitting your first patch

Make sure you have signed the CLA
Fork the repository.

We follow the Fork and Pull model as described here.

Clone your fork:

git clone http://github.com/<your_username>/document-api-python

Check out the development branch
```
git checkout development
```
Run the tests to make sure everything is peachy:
```
python -m unittest discover -v
```
Set up the feature, fix, or documentation branch.

It is recommended to use the format issue#-type-description (e.g. 13-fix-connection-bug) like so:
```
git checkout -b 13-feature-new-stuff
```
Code and commit!

Heres a quick checklist for ensuring a good pull request:
- Only touch the minimal amount of files possible while still accomplishing the goal.
- Ensure all indentation is done as 4-spaces and your editor is set to unix line endings.
- The code matches PEP8 style guides. If you cloned the repo you can run pycodestyle .
- Keep commit messages clean and descriptive. If the PR is accepted it will get Squashed into a single commit before merging, the commit messages will be used to generate the Merge commit message.
Add tests.

All of our tests live under the test/ folder in the repository. We use unittest and run them with python -m unittest discover -v. If a test needs a static file, like a twb/twbx, it should live under test/assets/
Update the documentation.

Our documentation is written in markdown and built with Jekyll on Github Pages. All of the documentation source files can be found in docs/docs.

When adding a new feature or improving existing functionality we may ask that you update the documentation along with your code.

If you are just making a PR for documentation updates (adding new docs, fixing typos, improving wording) the easiest method is to use the built in Edit this file in the Github UI
Submit to your fork.
Make a PR as described here against the development branch.
Wait for a review and address any feedback. While we try and stay on top of all issues and PRs, this isnt under active development so it might take a while for someone to respond. Politely pinging the PR after a few days with no response is OK, well try and respond with a timeline as soon as we are able.
Thats it! When the PR has received :rocket:s from members of the core team they will merge the PR

This site is open source. Suggestions and pull requests are welcome on our GitHub page.

© Copyright Salesforce, Inc. All rights reserved. Various trademarks held by their respective owners. Salesforce, Inc. Salesforce Tower, 415 Mission Street, 3rd Floor, San Francisco, CA 94105, United States

Documentation last generated on: 2026-07-02 19:44:24 +0000