Fix Python docs: correct Py.Decorator to Py.Decorate and fix examples

- Rename Py.Decorator to Py.Decorate (the actual API name)
- Replace record example with class example (records already compile to
  @DataClass automatically, and Py.Decorate cannot be used on records)
- Remove function decorator example (Fable doesn't support attributes on
  functions, only on types)
- Add single-argument form example for local decorators
- Move Class Attributes section before Python Decorators since the
  decorator example references Py.ClassAttributes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: dbrattli

docs/docs/python/features.md

@@ -458,73 +458,67 @@ def add(a: int32, b: int32) -> Any:
 
 `Py.python` executes as statements, so use `return` keyword to return values.
 
-## Python Decorators
+## Class Attributes
 
 <p class="tag is-info is-medium">
     Added in v5.0.0-alpha
 </p>
 
-`Py.Decorator` allows you to apply Python decorators to classes and functions.
+`Py.ClassAttributes` controls how class members are generated in Python.
 
 ```fs
 open Fable.Core
 
-[<Py.Decorator("dataclasses.dataclass")>]
-type User =
-    { Name: string
-      Age: int }
+[<Py.ClassAttributes(Py.ClassAttributeStyle.Attributes)>]
+type Config() =
+    member val Name = "default" with get, set
+    member val Port = 8080 with get, set
 ```
 
 generates:
 
 ```py
-@dataclasses.dataclass
-class User:
-    name: str
-    age: int32
-```
-
-You can also pass parameters to decorators:
-
-```fs
-[<Py.Decorator("functools.lru_cache", "maxsize=128")>]
-let expensiveFunction x = x * 2
+class Config:
+    name: str = "default"
+    port: int = 8080
 ```
 
-generates:
-
-```py
-@functools.lru_cache(maxsize=128)
-def expensive_function(x):
-    return x * 2
-```
+Without `ClassAttributes`, members would be generated as properties with instance backing.
 
-## Class Attributes
+## Python Decorators
 
 <p class="tag is-info is-medium">
     Added in v5.0.0-alpha
 </p>
 
-`Py.ClassAttributes` controls how class members are generated in Python.
+`Py.Decorate` allows you to apply Python decorators to types.
 
 ```fs
 open Fable.Core
 
-[<Py.ClassAttributes(Py.ClassAttributeStyle.Attributes)>]
-type Config() =
-    member val Name = "default" with get, set
-    member val Port = 8080 with get, set
+[<Py.Decorate("dataclass", "dataclasses")>]
+[<Py.ClassAttributes(Py.ClassAttributeStyle.Attributes, false)>]
+type DecoratedUser() =
+    member val Name: string = "" with get, set
+    member val Age: int = 0 with get, set
 ```
 
 generates:
 
 ```py
-class Config:
-    name: str = "default"
-    port: int = 8080
+@dataclass
+class DecoratedUser:
+    Age: int32 = int32.ZERO
+    Name: str = ""
 ```
 
-Without `ClassAttributes`, members would be generated as properties with instance backing.
+The single argument form can be used for local decorators where you don't need to import anything:
+
+```fs
+[<Py.Decorate("my_decorator")>]
+type MyClass() =
+    member val Value: int = 0 with get, set
+```
 
 ## `[<Erase>]`