diff --git a/assemblies/release-notes/assembly_mta-8-2-0.adoc b/assemblies/release-notes/assembly_mta-8-2-0.adoc
new file mode 100644
index 00000000..5e3a6e2c
--- /dev/null
+++ b/assemblies/release-notes/assembly_mta-8-2-0.adoc
@@ -0,0 +1,28 @@
+:_newdoc-version: 2.18.7
+:_template-generated: 2026-06-12
+:_mod-docs-content-type: ASSEMBLY
+
+ifdef::context[:parent-context-of-mta-8-2-0: {context}]
+
+ifndef::context[]
+[id="mta-8-2-0"]
+endif::[]
+ifdef::context[]
+[id="mta-8-2-0_{context}"]
+endif::[]
+= {ProductFirstRef} 8.2
+
+:context: mta-8-2-0
+
+[role="_abstract"]
+Review new features, enhancements, Technology Preview features, removed features, fixed issues, and known issues in {ProductFullName} 8.2.0.
+
+include::topics/release-notes-topics/ref_new-features-and-enhancements-8-2-0.adoc[leveloffset=+1]
+
+include::topics/release-notes-topics/ref_known-issues-8-2-0.adoc[leveloffset=+1]
+
+include::topics/release-notes-topics/ref_fixed-issues-8-2-0.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-mta-8-2-0[:context: {parent-context-of-mta-8-2-0}]
+ifndef::parent-context-of-mta-8-2-0[:!context:]
+
diff --git a/docs/release-notes/master.adoc b/docs/release-notes/master.adoc
index 3b2edda5..46e68d26 100644
--- a/docs/release-notes/master.adoc
+++ b/docs/release-notes/master.adoc
@@ -11,6 +11,8 @@ include::topics/templates/document-attributes.adoc[]
 = Release Notes
 
 
+include::assemblies/release-notes/assembly_mta-8-2-0.adoc[leveloffset=+1]
+
 include::assemblies/release-notes/assembly_mta-8-1.adoc[leveloffset=+1]
 
 include::assemblies/release-notes/assembly_mta-8-0.adoc[leveloffset=+1]
diff --git a/docs/topics/release-notes-topics/ref_fixed-issues-8-2-0.adoc b/docs/topics/release-notes-topics/ref_fixed-issues-8-2-0.adoc
new file mode 100644
index 00000000..57e47bbf
--- /dev/null
+++ b/docs/topics/release-notes-topics/ref_fixed-issues-8-2-0.adoc
@@ -0,0 +1,9 @@
+:_newdoc-version: 2.18.7
+:_template-generated: 2026-06-12
+:_mod-docs-content-type: REFERENCE
+
+[id="fixed-issues-8-2-0_{context}"]
+= Fixed issues
+
+[role="_abstract"]
+Review issues that have been fixed in {ProductFirstRef} ({ProductShortName}) version 8.2.0.
\ No newline at end of file
diff --git a/docs/topics/release-notes-topics/ref_known-issues-8-2-0.adoc b/docs/topics/release-notes-topics/ref_known-issues-8-2-0.adoc
new file mode 100644
index 00000000..9a5844d5
--- /dev/null
+++ b/docs/topics/release-notes-topics/ref_known-issues-8-2-0.adoc
@@ -0,0 +1,13 @@
+:_newdoc-version: 2.18.7
+:_template-generated: 2026-07-01
+:_mod-docs-content-type: REFERENCE
+
+[id="known-issues-8-2-0_{context}"]
+= Known issues
+
+[role="_abstract"]
+{ProductFirstRef} ({ProductShortName}) version 8.2.0 is affected by the following newly identified and previously known issues. A known issue is listed in all future release notes until resolved, at which point it is published as a fixed issue.
+
+// placeholder for https://redhat.atlassian.net/browse/MTA-7103
+// SME inputs: When running kubectl apply, if the namespace and its resources already exist on the target cluster, they will be silently overwritten. Since this is an issue with kubectl apply, it falls outside the scope of Crane.
+
diff --git a/docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-2-0.adoc b/docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-2-0.adoc
new file mode 100644
index 00000000..262214db
--- /dev/null
+++ b/docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-2-0.adoc
@@ -0,0 +1,24 @@
+:_newdoc-version: 2.18.7
+:_template-generated: 2026-06-12
+:_mod-docs-content-type: REFERENCE
+
+[id="new-features-and-enhancements-8-2-0_{context}"]
+= New features and enhancements
+
+[role="_abstract"]
+Review new features and enhancements in {ProductFirstRef} ({ProductShortName}) 8.2.0.
+
+
+// main mta-ops RN placeholder (decide whether we need individual big feature RNs mentioned below or just a general one)
+
+
+
+// MTA-6885 (multi-stage pipeline)
+
+
+
+// MTA-6886 (cluster-level dependencies)
+
+
+
+// MTA-6887 (validation)
\ No newline at end of file