minor fixes and explanations docker & OS X