Refactor best practices from the API refactoring issue and integrate them into the existing documentation. Signed-off-by: Peter Bigot <peter.bigot@nordicsemi.no>