Mark notes and warnings, fix broken link renderings within.

Docker-DCO-1.1-Signed-off-by: O.S. Tezer <ostezer@gmail.com> (github: ostezer)
Merge pull request #5307 from ostezer/docs-amend-notes-warnings

Mark notes and warnings, fix broken link renderings within.