doc: rework paragraph to be less awkward/repetative

Signed-off-by: wilsaj <wilson.andrew.j+github@gmail.com>
doc: format paragraph as note

Signed-off-by: wilsaj <wilson.andrew.j+github@gmail.com>