minor: fixing cross reference
DOCS-3020 part 1, the reference page only
DOCS-2757: update configuration example and reword intro to config file
DOCS-2757: updating cross references