improve documentation for save method