Add sphinx documentation for old assumptions in the core

maybe there is a simpler way to fix this, but...