make kill work, improve documentation for migrations