Clarify date/time auto-timestamps (#39)

dunhamjared · web-flow · commit d7d5351e53a2 · 2025-02-19T08:17:50.000+05:30
Enhance date/time documentation with details on auto-timestamps
diff --git a/content/docs/models/introduction.md b/content/docs/models/introduction.md
@@ -219,9 +219,9 @@ export default class User extends BaseModel {
 }
 ```
 
-Optionally, you can pass the `autoCreate` and `autoUpdate` options to always define the timestamps during the creation and the update operations. **Do note, setting these options doesn't modify the database table or its triggers.**
+Optionally, you can pass the `autoCreate` and `autoUpdate` options to automatically manage timestamps. `createdAt` is set when the record is first created, and `updatedAt` is set on both creation and every subsequent update. **Do note, these options do not modify the database schema itself. (e.g., adding triggers)**
 
-If you don't want Luxon and prefer regular `Date` objects, you still can use a regular `@column` in combination with `consume` and `prepare`
+If you don't want Luxon and prefer regular `Date` objects, you can use a regular `@column` in combination with `consume` and `prepare`
 
 ```ts
 import { BaseModel, column } from '@adonisjs/lucid/orm'

Original file line number	Diff line number	Diff line change
`@@ -219,9 +219,9 @@ export default class User extends BaseModel {`
`219`	`219`	`}`
`220`	`220`	```
`221`	`221`
`222`		-Optionally, you can pass the `autoCreate` and `autoUpdate` options to always define the timestamps during the creation and the update operations. Do note, setting these options doesn't modify the database table or its triggers.
	`222`	+Optionally, you can pass the `autoCreate` and `autoUpdate` options to automatically manage timestamps. `createdAt` is set when the record is first created, and `updatedAt` is set on both creation and every subsequent update. Do note, these options do not modify the database schema itself. (e.g., adding triggers)
`223`	`223`
`224`		-If you don't want Luxon and prefer regular `Date` objects, you still can use a regular `@column` in combination with `consume` and `prepare`
	`224`	+If you don't want Luxon and prefer regular `Date` objects, you can use a regular `@column` in combination with `consume` and `prepare`
`225`	`225`
`226`	`226`	```ts
`227`	`227`	`import { BaseModel, column } from '@adonisjs/lucid/orm'`