docs: add dynamic tools explanation and common pitfalls [closes DOC-991] #11012

Job	Run time
check-cross-refs	25s
check-generated-files	20s
links (3.13) / Documentation Build & Link Check (Python 3.13)	1m 58s
test (3.13) / make test #3.13	22s
lint (3.13) / make lint #3.13	22s
	3m 27s

Provide feedback