fixing typos and deprecated names, adding first scripts example
fixing typo
recommending installation in a virtualenv, fixing obvious typo on the way
adding install from sources section because the downloads area is outdated and deprecated
Merge pull request #1 from pybuilder/improved_docs

merged #1