clarified some of the documentation

- make the run php instruction more readable  
- noted the config requirement for base url in yml file  
- pointed to JDK for mavericks  
- noted js requirement at top of file