fixes issue 1 - be more specific about requirements and link to more information