work-in-progress weighted sum for both directions
documentation update