development guidelines don't have enough setup detail

[John Dickinson]

The development guidelines page (http://docs.openstack.org/developer/swift/development_guidelines.html) don't have enough setup detail for running tests.

Step one on this page should be (a reference to) how to set up a dev environment (http://docs.openstack.org/developer/swift/development_saio.html). At that point, all scripts and dependencies should "just work".

In addition to the reference to how to properly set up a dev environment, this page should also have information on how to set up the testing dependencies. That is, someone looking for how to run functional tests should find this page and be able to run the tests, including instructions that upgrade packages to get around the pip/setuptools/pbr errors around not understanding the requirements.txt file[1].

[1]
Exception:
Traceback (most recent call last):
 File "/usr/lib/python2.7/dist-packages/pip/basecommand.py", line 122, in main
   status = self.run(options, args)
 File "/usr/lib/python2.7/dist-packages/pip/commands/install.py", line 262, in run
   for req in parse_requirements(filename, finder=finder, options=options, session=session):
 File "/usr/lib/python2.7/dist-packages/pip/req.py", line 1632, in parse_requirements
   req = InstallRequirement.from_line(line, comes_from, prereleases=getattr(options, "pre", None))
 File "/usr/lib/python2.7/dist-packages/pip/req.py", line 173, in from_line
   return cls(req, comes_from, url=url, prereleases=prereleases)
 File "/usr/lib/python2.7/dist-packages/pip/req.py", line 71, in __init__
   req = pkg_resources.Requirement.parse(req)
 File "/usr/lib/python2.7/dist-packages/pkg_resources.py", line 2667, in parse
   reqs = list(parse_requirements(s))
 File "/usr/lib/python2.7/dist-packages/pkg_resources.py", line 2605, in parse_requirements
   line, p, specs = scan_list(VERSION,LINE_END,line,p,(1,2),"version spec")
 File "/usr/lib/python2.7/dist-packages/pkg_resources.py", line 2583, in scan_list
   "Expected ',' or end-of-list in",line,"at",line[p:]
ValueError: ("Expected ',' or end-of-list in", "dnspython>=1.12.0;python_version<'3.0'", 'at', ";python_version<'3.0'")