added more detail to both instructor-facing and dev-facing docs