External references
When referencing external resources, ensure that you are linking to a trustworthy source that is recognized as an authority.
For general websites, consider the following recommendations about the link text:
- Use the website name if you are linking to the home page.
- Use the page name if you are linking to a specific page.
- Authoritative sources for documents such as RFCs can have their own specific format for references, such as the RFC number.
Referencing RFCs
A Request for Comments (RFC) document is a formal document produced by different entities such as the Internet Engineering Task Force (IETF), covering many aspects of computer networking. RFCs describe the Internet’s technical foundations, such as addressing, routing, and transport technologies.
Use the following formatting when referencing an RFC:
RFC
(RFC, space, number up to four digits)
Example: CAA is a new DNS resource record type defined in RFC 6844.
Links
When linking to an RFC (or RFC section), consider using a link to the following website, which is the authoritative source according to IETF:
To get the link:
- Go to RFC Editor and search for the RFC number.
- Select HTML to open the HTML version.
- (optional) Navigate to a specific section, if necessary.
- Use the current URL as the link target in Developer Documentation.
URL example: