Review comments

dev/release/run-rat.sh

@@ -18,12 +18,14 @@
 # under the License.
 #
 
+RAT_VERSION=0.12
+
 # download apache rat
-if [ ! -f apache-rat-0.12.jar ]; then
-  curl -s https://repo1.maven.org/maven2/org/apache/rat/apache-rat/0.12/apache-rat-0.12.jar > apache-rat-0.12.jar
+if [ ! -f apache-rat-${RAT_VERSION}.jar ]; then
+  curl -s https://repo1.maven.org/maven2/org/apache/rat/apache-rat/${RAT_VERSION}/apache-rat-${RAT_VERSION}.jar > apache-rat-${RAT_VERSION}.jar
 fi
 
-RAT="java -jar apache-rat-0.12.jar -x "
+RAT="java -jar apache-rat-${RAT_VERSION}.jar -x "
 
 RELEASE_DIR=$(cd "$(dirname "$BASH_SOURCE")"; pwd)
 

docs/requirements.txt

@@ -2,6 +2,5 @@ breathe
 ipython
 matplotlib
 numpydoc
-recommonmark
 sphinx
 sphinx_rtd_theme

docs/source/python/pandas.rst

@@ -17,7 +17,7 @@
 
 .. _pandas_interop:
 
-pandas Integration
+Pandas Integration
 ==================
 
 To interface with `pandas <https://pandas.pydata.org/>`_, PyArrow provides

python/README.md

@@ -79,10 +79,10 @@ and look for the "custom options" section.
 ### Building the documentation
 
 ```bash
-pip install -r ../doc/requirements.txt
+pip install -r ../docs/requirements.txt
 python setup.py build_sphinx -s ../doc/source
 ```
 
 [2]: https://github.com/apache/arrow/blob/master/python/doc/source/development.rst
 [3]: https://github.com/pandas-dev/pandas
-[4]: https://docs.pytest.org/en/latest/
+[4]: https://docs.pytest.org/en/latest/