some fixes and clarifications to assert docs
some fixes and clarifications to assert docs

JonathonSonesen/pytest,oleg-alexandrov/pytest,hunse/pytest,hpk42/pytest,ropez/pytest,tareqalayan/pytest,hackebrot/pytest,ericdill/pytest,chillbear/pytest,davidszotten/pytest,ddboline/pytest,bukzor/pytest,eli-b/pytest,hunse/pytest,codewarrior0/pytest,oleg-alexandrov/pytest,omarkohl/pytest,jaraco/pytest,abusalimov/pytest,ojake/pytest,doordash/pytest,pytest-dev/pytest,icemac/pytest,etataurov/pytest,Bachmann1234/pytest,inirudebwoy/pytest,wfxiang08/pytest,rmfitzpatrick/pytest,gabrielcnr/pytest,userzimmermann/pytest,takluyver/pytest,codewarrior0/pytest,mhils/pytest,MengJueM/pytest,skylarjhdownes/pytest,Bjwebb/pytest,The-Compiler/pytest,pelme/pytest,MengJueM/pytest,malinoff/pytest,Carreau/pytest,bukzor/pytest,ionelmc/pytest,lukas-bednar/pytest,nicoddemus/pytest,ojake/pytest,takluyver/pytest,chillbear/pytest,doordash/pytest,ghostsquad/pytest,ghostsquad/pytest,mdboom/pytest,mbirtwell/pytest,markshao/pytest,rouge8/pytest,untitaker/pytest,gabrielcnr/pytest,nicoddemus/repo-test,Haibo-Wang-ORG/pytest,tgoodlet/pytest,Akasurde/pytest,omarkohl/pytest,txomon/pytest,The-Compiler/pytest,nicoddemus/repo-test,Carreau/pytest,ionelmc/pytest,Bjwebb/pytest,tomviner/pytest,userzimmermann/pytest,MichaelAquilina/pytest,Haibo-Wang-ORG/pytest,ericdill/pytest,tomviner/pytest,mhils/pytest,nicoddemus/pytest,RonnyPfannschmidt/pytest,wfxiang08/pytest,mdboom/pytest,rouge8/pytest,icemac/pytest,bubenkoff/pytest,vodik/pytest,vmalloc/dessert,chiller/pytest,untitaker/pytest,bubenkoff/pytest,pfctdayelise/pytest,Bachmann1234/pytest,mbirtwell/pytest,jb098/pytest,ropez/pytest,vodik/pytest,pelme/pytest,chiller/pytest,inirudebwoy/pytest,lukas-bednar/pytest,jb098/pytest,JonathonSonesen/pytest,hpk42/pytest,alfredodeza/pytest,abusalimov/pytest,flub/pytest