more comments to iride layer methods