BUG: Fixed vtkMRMLSceneViewNode referenced ID update

Also made some other minor cleanups and added comments (related to return values of scene methods, usage of smart pointers, etc.)