DOC: add explanation to doc/sphinxext

Closes #5221