Improve `tattr` & `adorn` doc comments

adorn really isn't so needed at all anymore with the new cligen/python/pq example, but eh.. it's like 28 lines of logic.

tattr (the general need for --) can be confusing. Try to be better.

Miscellaneous non-code doc clean-ups & dependency upgrades.