doc: Add warning about show layer and transform state.

Fixes #479.