Refine the setup instructions

[bengolder]

What are the basic assumptions?

• you are using unix command line
• you need some package manager to install command line tools, like homebrew
• you know know how to use command line
• you have basic command line build utilities
• don't forget git clone instructions
• need python3.4 or above
• (bad) need to install postgresql
• you have git installed
• have a virtual environment setup
• activate it

[bengolder]

The instructions for virtual environments are insufficient. It does not do a good job of covering conflicting versions fo python and versions of pip and virtualenv.
add the instructions for Python 3

[gauravmk]

You get an ImportError if you try running unless the root directory is part of you PYTHONPATH

[marata29]

typed gcc had to install command line tools

[bengolder]

howto instructions don't give any sense of time estimates

[gauravmk]

run with honcho and add a .env file

[marata29]

 Error: pg_config executable not found.

    Please add the directory containing pg_config to the PATH
    or specify the full executable path with the option:

        python setup.py build_ext --pg-config /path/to/pg_config build ...

    or with the pg_config option in 'setup.cfg'.

    ----------------------------------------
Command "python setup.py egg_info" failed with error code 1 in /private/var/folders/dq/sld4khqn4x9852sg77d43z680000gn/T/pip-build-62s0lrzz/psycopg2

[bhoeting]

The instructions don't include anything about the virtualenv. All that's required to get it working is

cd pdfhook
pyenv-3.5 .
source bin/activate

I'm not sure how pyvenv-3.5 got installed. Does it ship with brew install python3?

[bengolder]

@bhoeting that's likely. Alternatively, we can use

python3.5 -m venv .

to replace pyenv-3.5 ., and it might work more reliably because it only needs python3.5 to be available on PATH. Docs for venv are here: https://docs.python.org/3/library/venv.html

[bengolder]

Saying to install python3 and then later using the python3.5 binary is confusing.