updated namespace, documentation and ensured S3 generic/method consistency