document z-ordering properties of api