docstrings clarification
update on partial averagings