I'm decently fond of how ansible docs do it (for example) - consider ex. https://docs.ansible.com/ansible/2.9/modules/list_of_all_mod... which has a nice banner at the top saying this is an old version.