docs: improve NatSpec and clarify internal comments#1006

Dark-Brain07 wants to merge 1 commit intoUniswap:mainUniswap/v4-core:mainfrom

Dark-Brain07:mainDark-Brain07/v4-core:mainCopy head branch name to clipboard