added docs regarding namespaces
Merge pull request #186 from spotify/drewc/namespacedoc

added docs regarding namespaces