doc

Author: fi3ework

website/docs/en/guide/_meta.json

@@ -23,5 +23,10 @@
     "type": "dir",
     "name": "migration",
     "label": "Migration"
+  },
+  {
+    "type": "dir",
+    "name": "faq",
+    "label": "FAQ"
   }
 ]

website/docs/en/guide/faq/_meta.json

@@ -1 +1 @@
-["general", "features", "exceptions"]
+["features"]

website/docs/en/guide/faq/features.mdx

@@ -1 +1,30 @@
 # Features FAQ
+
+## How to preserve all comments in the output files?
+
+By default, Rslib uses SWC to remove comments. The corresponding SWC [jsc.minify.format](https://swc.rs/docs/configuration/minification#jscminifyformat) configuration is
+
+```js
+{
+    comments: 'some', //
+    preserveAnnotations: true,
+}
+```
+
+This will only preserve some legal comments and annotations. If you want to preserve all comments, you can refer to the following configuration
+
+```ts title="rslib.config.ts"
+export default {
+  output: {
+    minify: {
+      jsOptions: {
+        minimizerOptions: {
+          format: {
+            comments: 'all', // This will preserve all comments
+          },
+        },
+      },
+    },
+  },
+};
+```

website/docs/zh/guide/_meta.json

@@ -23,5 +23,10 @@
     "type": "dir",
     "name": "migration",
     "label": "迁移"
+  },
+  {
+    "type": "dir",
+    "name": "faq",
+    "label": "常见问题"
   }
 ]

website/docs/zh/guide/faq/_meta.json

@@ -1 +1 @@
-["general", "features", "exceptions"]
+["features"]

website/docs/zh/guide/faq/features.mdx

@@ -1 +1,30 @@
 # 功能类问题
+
+## 如何保留产物文件代码中的注释？
+
+默认情况下，Rslib 使用 SWC 清除注释，对应的 SWC 的 [jsc.minify.format](https://swc.rs/docs/configuration/minification#jscminifyformat) 配置为
+
+```js
+{
+    comments: 'some', //
+    preserveAnnotations: true,
+}
+```
+
+这将仅保留部分 legal 注释及 annotations。如果你想保留所有注释，可以参考如下配置
+
+```ts title="rslib.config.ts"
+export default {
+  output: {
+    minify: {
+      jsOptions: {
+        minimizerOptions: {
+          format: {
+            comments: 'all', // 将保留所有注释
+          },
+        },
+      },
+    },
+  },
+};
+```