And add some new sections on strategies for avoiding designing APIs around floating refs. Helps: #3037