3 Names of example items #
This section summarizes conventions for creating generic names for objects in documentation. Most of the following names are covered through entities. To check their spelling, refer to the Doc Kit repository at https://github.com/openSUSE/doc-kit/tree/main/entities. See also Section 9.3, “Entities”.
3.1 Domains #
Use http://www.example.com and http://www.example.org as example domains. Both domains were registered for use in documentation.
3.2 Host names #
Use objects of the solar system: For the most important system, use
sun. For other systems, use the names of
planets such as earth or
mars.
3.3 IPv4 addresses #
Use addresses from the class C subnet 192.168.255.0
for examples. That is, replace the final 0 with any
integer between 0 and 255. To
create examples using a larger setup, use addresses from the private
network ranges. For more information, see
http://en.wikipedia.org/wiki/Private_network.
3.4 IPv6 addresses #
Use addresses from the subnet 2001:0db8::/32 for
examples. That is, after the 2001:0db8: prefix, add
six four-digit numbers, each separated by a colon on both sides. Each of
the hexadecimal digits may have a value between 0 and
f. A valid example URL is
2001:0db8:0123:4567:89ab:cdef:1234:5678.
For more information, see
http://en.wikipedia.org/wiki/IPv6_subnetting_reference.
3.5 Users #
For example users, use free-software mascots, such as Tux (Linux Kernel), Wilber (The GIMP), Geeko (SUSE), Foxkeh (Firefox), Konqi (KDE), or Duke (Java).