From 0a94c8d1777b0999c802d651bec22466e35109c7 Mon Sep 17 00:00:00 2001
From: Matthieu Hochlander <matthieu@marmelab.com>
Date: Wed, 17 Sep 2025 11:30:06 +0200
Subject: [PATCH 1/3] Fix incorrect documentation of EditInDialogButton.

---
 docs/EditDialog.md         |  2 +-
 docs/ReferenceManyField.md | 20 ++++++++------------
 2 files changed, 9 insertions(+), 13 deletions(-)

diff --git a/docs/EditDialog.md b/docs/EditDialog.md
index cd05a937a45..cf8240b73fa 100644
--- a/docs/EditDialog.md
+++ b/docs/EditDialog.md
@@ -485,7 +485,7 @@ const EmployerSimpleFormWithFullyControlledDialogs = () => {
             <EditDialog
                 fullWidth
                 maxWidth="md"
-                record={{ employer_id: record?.id }} // pre-populates the employer_id to link the new customer to the current employer
+                record={record}
                 isOpen={isEditDialogOpen}
                 open={openEditDialog}
                 close={closeEditDialog}
diff --git a/docs/ReferenceManyField.md b/docs/ReferenceManyField.md
index dd3950b4dd1..8313edaffae 100644
--- a/docs/ReferenceManyField.md
+++ b/docs/ReferenceManyField.md
@@ -582,18 +582,14 @@ const EmployerEdit = () => (
               <DataTable>
                   <DataTable.Col source="first_name" />
                   <DataTable.Col source="last_name" />
-                  <DataTable.Col
-                      render={record => (
-                          <EditInDialogButton>
-                              <SimpleForm
-                                record={{ employer_id: record.id }}
-                              >
-                                  <TextInput source="first_name" />
-                                  <TextInput source="last_name" />
-                              </SimpleForm>
-                          </EditInDialogButton>
-                      )}
-                  />
+                  <DataTable.Col>
+                      <EditInDialogButton>
+                          <SimpleForm>
+                              <TextInput source="first_name" />
+                              <TextInput source="last_name" />
+                          </SimpleForm>
+                      </EditInDialogButton>
+                  </DataTable.Col>
               </DataTable>
           </ReferenceManyField>
       </SimpleForm>

From 8b5400bd0f7ac8a36e2664cd324d5becb45e0155 Mon Sep 17 00:00:00 2001
From: fzaninotto <fzaninotto@gmail.com>
Date: Tue, 4 Nov 2025 18:35:49 +0100
Subject: [PATCH 2/3] Fix code snippet

---
 docs/EditDialog.md | 104 ++++++++++++++++++++-------------------------
 1 file changed, 46 insertions(+), 58 deletions(-)

diff --git a/docs/EditDialog.md b/docs/EditDialog.md
index cf8240b73fa..41adf8a5f66 100644
--- a/docs/EditDialog.md
+++ b/docs/EditDialog.md
@@ -433,8 +433,8 @@ const sexChoices = [
     { id: 'female', name: 'Female' },
 ];
 
-const CustomerForm = (props: any) => (
-    <SimpleForm defaultValues={{ firstname: 'John', name: 'Doe' }} {...props}>
+const CustomerForm = () => (
+    <SimpleForm>
         <TextInput source="first_name" validate={required()} />
         <TextInput source="last_name" validate={required()} />
         <DateInput source="dob" label="born" validate={required()} />
@@ -442,66 +442,54 @@ const CustomerForm = (props: any) => (
     </SimpleForm>
 );
 
-const EmployerSimpleFormWithFullyControlledDialogs = () => {
-    const record = useRecordContext();
-
-    const [isEditDialogOpen, setIsEditDialogOpen] = useState(false);
-    const openEditDialog = useCallback(() => {
-        setIsEditDialogOpen(true);
+const EmployerEdit = () => {
+    const [record, setRecord] = React.useState<any>(undefined);
+    const closeDialog = React.useCallback(() => {
+        setRecord(undefined);
     }, []);
-    const closeEditDialog = useCallback(() => {
-        setIsEditDialogOpen(false);
-    }, []);
-
     return (
-        <SimpleForm>
-            <TextInput source="name" validate={required()} />
-            <TextInput source="address" validate={required()} />
-            <TextInput source="city" validate={required()} />
-            <ReferenceManyField
-                label="Customers"
-                reference="customers"
-                target="employer_id"
-            >
-                <DataTable>
-                    <DataTable.Col source="id" />
-                    <DataTable.Col source="first_name" />
-                    <DataTable.Col source="last_name" />
-                    <DataTable.Col source="dob" label="born" field={DateField} />
-                    <DataTable.Col source="sex">
-                        <SelectField source="sex" choices={sexChoices} />
-                    </DataTable.Col>
-                    <DataTable.Col>
-                        <Button
-                            label="Edit customer"
-                            onClick={() => openEditDialog()}
-                            size="medium"
-                            variant="contained"
-                            sx={{ mb: 4 }}
-                        />
-                    <DataTable.Col>
-                </DataTable>
-            </ReferenceManyField>
-            <EditDialog
-                fullWidth
-                maxWidth="md"
-                record={record}
-                isOpen={isEditDialogOpen}
-                open={openEditDialog}
-                close={closeEditDialog}
-                resource="customers"
-            >
-                <CustomerForm />
-            </EditDialog>
-        </SimpleForm>
+        <Edit>
+            <SimpleForm>
+                <TextInput source="name" validate={required()} />
+                <TextInput source="address" validate={required()} />
+                <TextInput source="city" validate={required()} />
+                <ReferenceManyField
+                    label="Customers"
+                    reference="customers"
+                    target="employer_id"
+                >
+                    <DataTable>
+                        <DataTable.Col source="id" />
+                        <DataTable.Col source="first_name" />
+                        <DataTable.Col source="last_name" />
+                        <DataTable.Col label="born">
+                            <DateField source="dob" label="born" />
+                        </DataTable.Col>
+                        <DataTable.Col source="sex">
+                            <SelectField source="sex" choices={sexChoices} />
+                        </DataTable.Col>
+                        <DataTable.Col render={record => (
+                            <Button
+                                label="Edit customer"
+                                onClick={() => setRecord(record)}
+                            />
+                        )} />
+                    </DataTable>
+                </ReferenceManyField>
+                <EditDialog
+                    record={record}
+                    resource="customers"
+                    isOpen={!!record}
+                    close={closeDialog}
+                    fullWidth
+                    maxWidth="md"
+                >
+                    <CustomerForm />
+                </EditDialog>
+            </SimpleForm>
+        </Edit>
     );
 };
-
-const EmployerEdit = () => (
-    <Edit>
-        <EmployerSimpleFormWithFullyControlledDialogs />
-    </Edit>
-);
 ```
 
 {% endraw %}

From feba805c01afacd963fb9db2ff3c739fc904e03e Mon Sep 17 00:00:00 2001
From: Gildas Garcia <1122076+djhi@users.noreply.github.com>
Date: Wed, 5 Nov 2025 09:35:09 +0100
Subject: [PATCH 3/3] Improve labels

---
 docs/EditDialog.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/EditDialog.md b/docs/EditDialog.md
index 41adf8a5f66..98895bc7644 100644
--- a/docs/EditDialog.md
+++ b/docs/EditDialog.md
@@ -437,7 +437,7 @@ const CustomerForm = () => (
     <SimpleForm>
         <TextInput source="first_name" validate={required()} />
         <TextInput source="last_name" validate={required()} />
-        <DateInput source="dob" label="born" validate={required()} />
+        <DateInput source="dob" label="Born" validate={required()} />
         <SelectInput source="sex" choices={sexChoices} />
     </SimpleForm>
 );
@@ -463,7 +463,7 @@ const EmployerEdit = () => {
                         <DataTable.Col source="first_name" />
                         <DataTable.Col source="last_name" />
                         <DataTable.Col label="born">
-                            <DateField source="dob" label="born" />
+                            <DateField source="dob" label="Born" />
                         </DataTable.Col>
                         <DataTable.Col source="sex">
                             <SelectField source="sex" choices={sexChoices} />