added internal documentation
improved null handling in lists and maps
improved null handling for repositories