append/extend tweaks for return length, doc tweaks