docs: add configuration doc

fixes #1728