improved documentation for sharing fxns