Merge pull request #22 from andreeap/master

Update README.md - thanks
Update README.md
Merge pull request #25 from andreeap/master

Update README.md
Update docs for carton wrappers.
Specify path to perl explicitly in ~/.metacpanrc

I think that file is gone, but the vagrant user doesn't get the right perl in
its path, so this is a quick fix.
Update index-cpan script to catch up with puppet changes.
Create metacpan_server_local.conf if it doesn't already exist.
Add note about setting the path to CPAN in API config.
Add docs about testing login in dev and prod
add instructions for running part of the test suite
Merge pull request #27 from rose/testdoc

add instructions for running part of the test suite
combine HELP.md into FAQs.md
add introduction with links to api and manual install docs
compress initial install commands
move information on provisioning error from README to FAQ
finish initial setup section
reorganize faq and readme
tweak markdown
put requirements under initial setup
add table of contents