docs are semi-smart about linking to one another