problems for shared reference serialization
improved documentation