Add sphinx documentation for old assumptions in the core

is this one different because of the parentheses?