Merge pull request #7380 from nocodb/docs/system-fields

docs: system fields update

packages/noco-docs/docs/070.fields/040.field-types/070.date-time-based/050.created-time.md

@@ -0,0 +1,29 @@
+---
+title: 'Created Time'
+description: 'This article explains how to create & work with a Created Time field.'
+tags: ['Fields', 'Field types', 'Date & Time', 'System fields']
+keywords: ['Fields', 'Field types', 'Date & Time', 'System fields', 'Created Time']
+---
+
+Since version v0.204.0 (Jan 2024), NocoDB internally captures the time when record was created. This information is stored as a system field in the database & is hidden in the table by default. To view this information on the UI, you can either enable `Show System Fields` OR create a `Created Time` field manually by following the steps below.
+
+Default system field can be only hidden from UI. It cannot be modified, duplicated or deleted.
+
+:::note
+- When connected to an external database, `CreatedTime` field is not created automatically. You can create a `CreatedTime` field manually by following the steps below.
+- `CreatedTime` field is empty indicates the record predates the created at feature (v0.204.0, Jan 2024). Prior to this feature release, it was possible to remove this from the table.
+:::
+
+## Create a `CreatedTime` field
+1. Click on `+` icon to the right of `Fields header`
+2. On the dropdown modal, enter the field name (Optional).
+3. Select the field type as `CreatedTime` from the dropdown.
+4. Click on `Save Field` button.
+
+![image](/img/v2/fields/types/created-time.png)
+
+## Cell display
+`CreatedTime` field is displayed as a read-only field in the table view. It is displayed as a date & time string in the format `DD MMM YYYY, HH:mm`.
+
+## Related fields
+- [Last Modified Time](060.last-modified-time.md)

packages/noco-docs/docs/070.fields/040.field-types/070.date-time-based/060.last-modified-time.md

@@ -0,0 +1,33 @@
+---
+title: 'Last Modified Time'
+description: 'This article explains how to create & work with a last modified time field.'
+tags: ['Fields', 'Field types', 'Date & Time', 'System fields']
+keywords: ['Fields', 'Field types', 'Date & Time', 'System fields', 'Last Modified Time']
+---
+
+Since version v0.204.0 (Jan 2024), NocoDB internally captures the time when record was modified. This information is stored as a system field in the database & is hidden in the table by default. To view this information on the UI, you can either enable `Show System Fields` OR create a `Last Modified Time` field manually by following the steps below.
+
+Default system field can be only hidden from UI. It cannot be modified, duplicated or deleted.
+
+:::note
+- When connected to an external database, `LastModifiedTime` field is not created automatically. You can create a `LastModifiedTime` field manually by following the steps below.
+- `LastModifiedTime` field is empty indicates 
+  - the record predates the `LastModifiedTime` feature (v0.204.0, Jan 2024). Prior to this feature release, it was possible to remove the `LastModifiedTime` field from the table.
+  - the record was never modified.
+  - external database connection : information is captured only after the field is explicitly created.
+:::
+
+## Create a `LastModifiedTime` field
+1. Click on `+` icon to the right of `Fields header`
+2. On the dropdown modal, enter the field name (Optional).
+3. Select the field type as `LastModifiedTime` from the dropdown.
+4. Click on `Save Field` button.
+
+![image](/img/v2/fields/types/last-modified-time.png)
+
+## Cell display
+`LastModifiedTime` field is displayed as a read-only field in the table view. It is displayed as a date & time string in the format `DD MMM YYYY, HH:mm`.
+
+## Related fields
+- [Created Time](050.created-time.md)
+

packages/noco-docs/docs/070.fields/040.field-types/080.user-based/020.created-by.md

@@ -0,0 +1,32 @@
+---
+title: 'Created By'
+description: 'This article explains how to create & work with a Created By field.'
+tags: ['Fields', 'Field types', 'Created By']
+keywords: ['Fields', 'Field types', 'Created By']
+---
+
+Since version v0.204.0 (Jan 2024), NocoDB internally captures the user who created a record. This information is stored as a system field in the database & is not included in the table by default. To view this information on the table, you can create a `Created By` field manually by following the steps below.
+
+## Create a `Created By` field
+1. Click on `+` icon to the right of `Fields header`
+2. On the dropdown modal, enter the field name (Optional).
+3. Select the field type as `CreatedBy` from the dropdown.
+4. Click on `Save Field` button.
+
+![image](/img/v2/fields/types/created-by.png)
+
+:::note
+- When connected to an external database, user creating record information is not captured automatically. You can create a `Created By` field manually by following the steps above. For external database connections, this field is not a system field & can be deleted.
+- `Created By` field is empty indicates the record either
+  - predates the created by feature (v0.204.0, Jan 2024). Prior to this feature release, this information was not captured.
+  - was created using shared form.
+  - external database connection : information is captured only after the field is explicitly created.
+:::
+
+## Cell display
+`Created By` field is displayed as a read-only field in the table view. Displays email address of the user who created the record if the user has no display name set. If the user has a display name set, the display name is displayed.
+
+## Related fields
+- [Last Modified By](030.last-modified-by.md)
+
+

packages/noco-docs/docs/070.fields/040.field-types/080.user-based/030.last-modified-by.md

@@ -0,0 +1,32 @@
+---
+title: 'Last Modified By'
+description: 'This article explains how to create & work with a Last Modified By field.'
+tags: ['Fields', 'Field types', 'Last Modified By']
+keywords: ['Fields', 'Field types', 'Last Modified By']
+---
+
+Since version v0.204.0 (Jan 2024), NocoDB internally captures the user who last modified a record. This information is stored as a system field in the database & is not included in the table by default. To view this information on the table, you can create a `Last Modified By` field manually by following the steps below.
+
+## Create a `Last Modified By` field
+1. Click on `+` icon to the right of `Fields header`
+2. On the dropdown modal, enter the field name (Optional).
+3. Select the field type as `LastModifiedBy` from the dropdown.
+4. Click on `Save Field` button.
+
+![image](/img/v2/fields/types/last-modified-by.png)
+
+:::note
+- When connected to an external database, user last modifying record information is not captured automatically. You can create a `Last Modified By` field manually by following the steps above. For external database connections, this field is not a system field & can be deleted.
+- `Last Modified By` field is empty indicates the record either
+  - record was created & never modified. 
+  - predates the last modified by feature (v0.204.0, Jan 2024). Prior to this feature release, this information was not captured.
+  - external database connection : information is captured only after the field is explicitly created.
+- `Last Modified By` field is not updated when a record is initially created (is initialized to NULL).
+:::
+
+## Cell display
+`Last Modified By` field is displayed as a read-only field in the table view. Displays email address of the user who last modified the record if the user has no display name set. If the user has a display name set, the display name is displayed.
+
+## Related fields
+- [Created By](020.created-by.md)
+