Richard,
This will function correctly, in older versions the data in the zip should be the content of the files directory without the files directory itself. Maybe if you run into issues this could be the cause of the files not being uploaded correctly. See this version 3 documentation page, it might still apply... I do agree that more documentation on this matter would be good.