doc: documentation: Update outdated file paths

This commit updates the documentation guidelines to reflect the
refactored documentation paths.

It also corrects the unnecessary escapes of the backticks.

Signed-off-by: Stephanos Ioannidis <stephanos.ioannidis@nordicsemi.no>