Cleanup, clarifications to the documentation and error messages

Fixed slight logic error in Scene::addSceneElement call
Documentation updates