migration docblocks
fixing potential issues