docs: add note regarding accessor (#4521)

mobxjs · Feb 11, 2025 · 09edf2b · 09edf2b
1 parent e01114a
commit 09edf2b
Showing 1 changed file with 15 additions and 13 deletions.
diff --git a/docs/enabling-decorators.md b/docs/enabling-decorators.md
@@ -39,24 +39,24 @@ With modern decorators, it is no longer needed to call `makeObservable` / `makeA
 }
 ```
 
-- Vite configuration
+-   Vite configuration
 
 ```js
 // vite.config.js
 {
     plugins: [
-      react({
-        babel: {
-          plugins: [
-            [
-              "@babel/plugin-proposal-decorators",
-              {
-                version: "2023-05",
-              },
-            ],
-          ],
-        },
-      }),
+        react({
+            babel: {
+                plugins: [
+                    [
+                        "@babel/plugin-proposal-decorators",
+                        {
+                            version: "2023-05"
+                        }
+                    ]
+                ]
+            }
+        })
     ]
 }
 ```
@@ -140,6 +140,8 @@ To migrate from legacy decorators to modern decorators, perform the following st
 2. Remove all `makeObservable(this)` calls from class constructors that use decorators.
 3. Replace all instances of `@observable` (and variations) with `@observable accessor`
 
+Please note that adding `accessor` to a class property will change it into `get` and `set` class methods. Unlike class properties, class methods are not enumerable. This may introduce new behavior with some APIs, such as `Object.keys`, `JSON.stringify`, etc.
+
 </details>
 
 <details id="gotchas"><summary>Decorator changes / gotchas</summary>