Documentation: domains and ip-addresses

Often, in front of system administrators, as well as in front of a lot of other people around the line, there is a need to write articles, short guides and recipes for setting up equipment and all sorts of software. In a huge number of this kind of publications can be found references to ip-addresses and domain names; at the same time, the authors' imagination knows no bounds; there are all kinds of addresses that are impossible from the point of view of binary arithmetic such as “120.340.560.780/22” and domains, for example, “domen.ru”, “test.net”, etc.

I would like to warn the authors against this practice, because it causes confusion in the documentation, especially in the case of editing an article compiled by several people, and also directly contradicts the recommendations of the IETF Committee, which has quite clear and formalized recommendations on this matter:

• According to RFC 2606 , domain and subdomain usage is allowed as domain names for examples in documentation: .example, example.com, example.net, and example.org
• According to RFC 5735 as a “white” ip-address for examples in the documentation, it is possible to use ip-ranges: 192.0.2.0/24, 198.51.100.0/24 and 203.0.113.0/24

Colleagues, let's write documentation in accordance with our own standards. So, in the end, it turns out better.