better doc for #1890 based on #1932
better doc for #1890 based on #1932

vmalloc/dessert,txomon/pytest,tareqalayan/pytest,rmfitzpatrick/pytest,markshao/pytest,hpk42/pytest,davidszotten/pytest,tomviner/pytest,tomviner/pytest,eli-b/pytest,skylarjhdownes/pytest,pytest-dev/pytest,jaraco/pytest,alfredodeza/pytest,hackebrot/pytest,MichaelAquilina/pytest,ddboline/pytest,Akasurde/pytest,nicoddemus/pytest,nicoddemus/pytest,flub/pytest,RonnyPfannschmidt/pytest,pfctdayelise/pytest,The-Compiler/pytest,The-Compiler/pytest,malinoff/pytest,hpk42/pytest,tgoodlet/pytest,etataurov/pytest