delta k fix, and documentation updates as discussed in #248, for #305