Should we mention/dosument this in the API?

The shutdown hook is a kind of a last resort. But the truth is we could mention this in the API.

Regarding rest skip/removal...

We can't just remove the only assertion we have in the test. The other methods are utility methods using Arquillian Deployer API. Adding a simple profile to exclude these tests for Windows family OS seems reasonable to me.