test: improve docs for when using HEAD or similar flags

Closes #29791.

Signed-off-by: Adam Vandenberg <flangy@gmail.com>
add --devel to fetch docs
reword test docs
regenerate manual