docs: improve middleware documentation readability

docs: improve middleware documentation readability #1203