adds more context in docs

[ci skip]