Docs: update pybind11 migration guide for enums

Now that we moved to pybind11's new native enums, !894 (merged), our guidelines need a few changes.

Also updated a test to verify the new behaviour.