add documentation for onShow

fixes #551