On Mon, Jun 01, 2020 at 09:48:09PM -0700, John Hubbard wrote: > However, the fact that this is under discussion hints at the need for a > bit of documentation help. What do you think about adding some notes about > all of this to, say, Documentation/vm/page_migration.rst ? Yes, that would be good. I understand the intent better now but still think the 'failure' event could be misinterpreted as outright failure instead of splitting followed by successfully moving the constituent pages. It might help to clarify in the changelog as well.