[libc-commits] [libc] [libc][docs] codify Policy on Assembler Sources (PR #88185)

[Guillaume Chatelet via libc-commits]

================
@@ -186,3 +186,44 @@ We expect contributions to be free of warnings from the `minimum supported
 compiler versions`__ (and newer).
 
 .. __: https://libc.llvm.org/compiler_support.html#minimum-supported-versions
+
+Policy on Assembly sources
+===========================
+
+Coding in high level languages such as C++ provides benefits relative to low
+level languages like Assembly, such as:
+
+* Improved safety
+* Compile time diagnostics
+* Instrumentation
+
+  * Code coverage
+  * Profile collection
+* Sanitization
+* Automatic generation of debug info
+
+While it's not impossible to have Assembly code that correctly provides all of
+the above, we do not wish to maintain such Assembly sources in llvm-libc.
+
+That said, there a few functions provided by llvm-libc that are impossible
----------------
gchatelet wrote:

there **are** a few

https://github.com/llvm/llvm-project/pull/88185