slightly improved annotation in code + extra minor hints in assignment description