[jira] [Created] (AIRFLOW-2501) CONTRIBUTING.md missing develop extra for documentation build script

["Tim Swast (JIRA)" <ji...@apache.org>]

Tim Swast created AIRFLOW-2501:
----------------------------------

             Summary: CONTRIBUTING.md missing develop extra for documentation build script
                 Key: AIRFLOW-2501
                 URL: https://issues.apache.org/jira/browse/AIRFLOW-2501
             Project: Apache Airflow
          Issue Type: Bug
          Components: Documentation
            Reporter: Tim Swast


The [CONTRIBUTING.md|https://github.com/apache/incubator-airflow/blob/master/CONTRIBUTING.md] docs mention "you need to have installed airflow with the {{doc}} extra" but they do not mention that the development extras are also required. I attempted to do the minimal installation on a fresh virtualenv and got an import error.
  

{{$ pip install -e .}}
{{...}}
{{$ pip install -e .[doc]}}
 {{...}}
 {{$ cd docs}}
 {{$ ./build.sh}}
 {{rm: _build: No such file or directory}}
 {{sphinx-build -b html -d _build/doctrees . _build/html}}
 {{Running Sphinx v1.7.4}}{{Configuration error:}}
 {{There is a programable error in your configuration file:}}{{Traceback (most recent call last):}}
 {{ File "/Users/swast/.pyenv/versions/3.6.4/envs/airflow-py3/lib/python3.6/site-packages/sphinx/config.py", line 161, in __init__}}
 \{{ execfile_(filename, config)}}
 \{{ File "/Users/swast/.pyenv/versions/3.6.4/envs/airflow-py3/lib/python3.6/site-packages/sphinx/util/pycompat.py", line 150, in execfile_}}
 \{{ exec_(code, _globals)}}
 \{{ File "conf.py", line 16, in <module>}}
 \{{ import mock}}
 {{ModuleNotFoundError: No module named 'mock'}}{{make: *** [html] Error 2}}



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)