Helping with documentation¶
A great way to contribute to the project is to improve documentation.
If you are an Arrow user and you found some docs to be incomplete or inaccurate, share your hard-earned knowledge with the rest of the community.
If you didn’t come across something to improve in the documentation itself, you can search for an issue on JIRA.
When searching for JIRA issue that deals with documentation, try selecting Components from the More tab in JIRA search and select Documentation from the list.
See Example search.
Documentation improvements are also a great way to gain some experience with our submission and review process without requiring a lot of local development environment setup.
Many documentation-only changes can be made directly in the GitHub web interface by clicking the Edit this page on the right top corner of the documentations page. This will handle making a fork and a pull request for you.
You could also build the entire project, make the change locally on your branch and make the PR this way. But it is by no means superior to simply editing via GitHub.
If you wish to build the documentation locally, follow detailed instructions on Building the Documentation.
Where to find the correct file to change?¶
Most of the documentation is located in the
docs/source of the Arrow
library. Source folder includes:
C++ documentation section:
Specificatons and protocols section:
To edit API reference documentation for Python, you will need to edit the docstrings of the functions and methods located in the
pyarrowpackage itself. For example, to edit pyarrow.Array you will need to edit
It is similar for C++.
The documentation for the arrow R package (which is published on the pkgdown site at
arrow.apache.org/docs/r/)is located within the
Cookbooks have their own repository https://github.com/apache/arrow-cookbook and can be separately cloned and built.