added more scoping text and explanation of properties