sharing cleanup

better commenting