updated documentation and demographics objects
improved support for demographics collection