doc: allow notes on Param API Reference pages

The notes that Param pages will contain after #6733 are added manually,
and because of it we need to add markers to differentiate between
automated and manual content, equal to what we do for class pages.

Signed-off-by: Antonio Torres <antorres@redhat.com>
Reviewed-By: Alexander Bokovoy <abokovoy@redhat.com>
Reviewed-By: Rob Crittenden <rcritten@redhat.com>

doc/api/A6Record.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _A6Record:
 
-# A6Record
+# A6Record
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/AAAARecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _AAAARecord:
 
-# AAAARecord
+# AAAARecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/AFSDBRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _AFSDBRecord:
 
-# AFSDBRecord
+# AFSDBRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/APLRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _APLRecord:
 
-# APLRecord
+# APLRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/ARecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _ARecord:
 
-# ARecord
+# ARecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/AccessTime.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _AccessTime:
 
-# AccessTime
+# AccessTime
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Any.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Any:
 
-# Any
+# Any
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/BinaryFile.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _BinaryFile:
 
-# BinaryFile
+# BinaryFile
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Bool.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Bool:
 
-# Bool
+# Bool
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Bytes.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Bytes:
 
-# Bytes
+# Bytes
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/BytesEnum.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _BytesEnum:
 
-# BytesEnum
+# BytesEnum
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/CERTRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _CERTRecord:
 
-# CERTRecord
+# CERTRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/CNAMERecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _CNAMERecord:
 
-# CNAMERecord
+# CNAMERecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Certificate.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Certificate:
 
-# Certificate
+# Certificate
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/CertificateSigningRequest.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _CertificateSigningRequest:
 
-# CertificateSigningRequest
+# CertificateSigningRequest
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DHCIDRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DHCIDRecord:
 
-# DHCIDRecord
+# DHCIDRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DLVRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DLVRecord:
 
-# DLVRecord
+# DLVRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DNAMERecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DNAMERecord:
 
-# DNAMERecord
+# DNAMERecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DNOrURL.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DNOrURL:
 
-# DNOrURL
+# DNOrURL
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DNParam.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DNParam:
 
-# DNParam
+# DNParam
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DNSNameParam.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DNSNameParam:
 
-# DNSNameParam
+# DNSNameParam
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DNSRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DNSRecord:
 
-# DNSRecord
+# DNSRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DSRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DSRecord:
 
-# DSRecord
+# DSRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Data.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Data:
 
-# Data
+# Data
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/DateTime.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _DateTime:
 
-# DateTime
+# DateTime
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Decimal.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Decimal:
 
-# Decimal
+# Decimal
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Dict.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Dict:
 
-# Dict
+# Dict
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Enum.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Enum:
 
-# Enum
+# Enum
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/File.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _File:
 
-# File
+# File
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Flag.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Flag:
 
-# Flag
+# Flag
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/ForwardRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _ForwardRecord:
 
-# ForwardRecord
+# ForwardRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/HINFORecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _HINFORecord:
 
-# HINFORecord
+# HINFORecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/HIPRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _HIPRecord:
 
-# HIPRecord
+# HIPRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/HostPassword.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _HostPassword:
 
-# HostPassword
+# HostPassword
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/IA5Str.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _IA5Str:
 
-# IA5Str
+# IA5Str
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/IPSECKEYRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _IPSECKEYRecord:
 
-# IPSECKEYRecord
+# IPSECKEYRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Int.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Int:
 
-# Int
+# Int
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/IntEnum.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _IntEnum:
 
-# IntEnum
+# IntEnum
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/KEYRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _KEYRecord:
 
-# KEYRecord
+# KEYRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/KXRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _KXRecord:
 
-# KXRecord
+# KXRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/LOCRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _LOCRecord:
 
-# LOCRecord
+# LOCRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/MDRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _MDRecord:
 
-# MDRecord
+# MDRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/MINFORecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _MINFORecord:
 
-# MINFORecord
+# MINFORecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/MXRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _MXRecord:
 
-# MXRecord
+# MXRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/NAPTRRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _NAPTRRecord:
 
-# NAPTRRecord
+# NAPTRRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/NSECRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _NSECRecord:
 
-# NSECRecord
+# NSECRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/NSRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _NSRecord:
 
-# NSRecord
+# NSRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/NXTRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _NXTRecord:
 
-# NXTRecord
+# NXTRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Number.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Number:
 
-# Number
+# Number
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/OTPTokenKey.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _OTPTokenKey:
 
-# OTPTokenKey
+# OTPTokenKey
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/PTRRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _PTRRecord:
 
-# PTRRecord
+# PTRRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Password.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Password:
 
-# Password
+# Password
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Principal.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Principal:
 
-# Principal
+# Principal
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/RPRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _RPRecord:
 
-# RPRecord
+# RPRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/RRSIGRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _RRSIGRecord:
 
-# RRSIGRecord
+# RRSIGRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/SIGRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _SIGRecord:
 
-# SIGRecord
+# SIGRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/SPFRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _SPFRecord:
 
-# SPFRecord
+# SPFRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/SRVRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _SRVRecord:
 
-# SRVRecord
+# SRVRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/SSHFPRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _SSHFPRecord:
 
-# SSHFPRecord
+# SSHFPRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/SerialNumber.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _SerialNumber:
 
-# SerialNumber
+# SerialNumber
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/Str.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _Str:
 
-# Str
+# Str
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/StrEnum.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _StrEnum:
 
-# StrEnum
+# StrEnum
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/TLSARecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _TLSARecord:
 
-# TLSARecord
+# TLSARecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/TXTRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _TXTRecord:
 
-# TXTRecord
+# TXTRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/URIRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _URIRecord:
 
-# URIRecord
+# URIRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

doc/api/UnsupportedDNSRecord.md

@@ -1,3 +1,5 @@
+[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
 .. _UnsupportedDNSRecord:
 
-# UnsupportedDNSRecord
+# UnsupportedDNSRecord
+[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)

makeapi.in

@@ -277,10 +277,14 @@ def make_api_reference(validate_only=False):
     will be created in Markdown format.
     """
 
-    class_template = """[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)
+    # Markers to separate automated content from manual notes
+    automated_marker_start = "[//]: # (THE CONTENT BELOW IS GENERATED. DO NOT EDIT.)"  # noqa: E501
+    automated_marker_end = "[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)"  # noqa: E501
+
+    class_template = """{automated_marker_start}
 {reference}
 
-[//]: # (ADD YOUR NOTES BELOW. THESE WILL BE PICKED EVERY TIME THE DOCS ARE REGENERATED. //end)
+{automated_marker_end}
 {notes}
 """
 
@@ -331,9 +335,21 @@ def make_api_reference(validate_only=False):
 
     for param in ipa_classes:
         lines = [
+            automated_marker_start,
             ".. _%s:\n" % param.__name__,
             "# %s" % param.__name__,
+            automated_marker_end
         ]
+
+        try:
+            with open("doc/api/%s.md" % param.__name__, "r") as f:
+                # Read notes written to page
+                notes = f.read().split("//end)")[1].strip()
+        except FileNotFoundError:
+            notes = ""
+
+        lines.append(notes)
+
         api_contents["doc/api/%s.md" % param.__name__] = "\n".join(lines)
         param_lines.append("   %s.md" % param.__name__)
 
@@ -391,13 +407,17 @@ def make_api_reference(validate_only=False):
 
         try:
             with open("doc/api/%s.md" % cmd.name, "r") as f:
-                # Read notes write to template
+                # Read notes written to template
                 notes = f.read().split("//end)")[1].strip()
         except FileNotFoundError:
                 notes = notes_template
 
         out = class_template.format(
-                reference="\n".join(lines), notes=notes).strip()
+            automated_marker_start=automated_marker_start,
+            reference="\n".join(lines),
+            notes=notes,
+            automated_marker_end=automated_marker_end
+        ).strip()
         api_contents["doc/api/%s.md" % cmd.name] = out
 
     api_contents["doc/api/commands.rst"] = "\n".join(cmd_lines)