diff --git a/lld/MachO/ld64-vs-lld.rst b/lld/MachO/ld64-vs-lld.rst
new file mode 100644
--- /dev/null
+++ b/lld/MachO/ld64-vs-lld.rst
@@ -0,0 +1,16 @@
+==================
+LD64 vs LLD-MACHO
+==================
+
+This doc lists all significant deliberate differences in behavior between LD64 and LLD-MachO.
+
+ObjC symbols treatment
+**********************
+There are differences in how LLD and LD64 handle ObjC symbols loaded from archives.
+
+- LD64:
+   * Duplicate ObjC symbols from the same archives will not raise an error. LD64 will pick the first one.   
+   * Duplicate ObjC symbols from different archives will raise a "duplicate symbol" error.
+- LLD:
+   * Duplicate symbols, regardless of which archives they are from, will raise errors.
+