This string appears all throughout the docs:

Be aware that this method suffers from the same limitations as Schema.serialize().

These limitations should be linked everytime that appears.