-
Notifications
You must be signed in to change notification settings - Fork 2.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: add page on created_at / updated_at timestamps (close #2880) #5223
docs: add page on created_at / updated_at timestamps (close #2880) #5223
Conversation
Deploy preview for hasura-docs ready! Built with commit 9ddbb25 |
Deploy preview for hasura-docs ready! Built with commit dc36c1a |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- can we just call the page "Adding created_at / updated_at timestamps" as that is what the page is actually talking about. The current title and presentation left me extremely confused about the intent of this page. created_at and updated_at are not exactly default values for timestamp values but are rather special columns whose values can be set by using some default values
updated_at
is not achievable by adding a simple default value. One needs to add a postgres trigger that updates the timestamp value after each update. Hence the instructions under the ClI/API tab are inaccurate
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@marionschleifer This looks good. Just one change, for the updated_at code-block you might want to use code-block:: plpgsql
in place of code-block:: sql
to get the highlighting to work
@sezgi The page has kind of changed completely so you should take a look at the changes again I guess. Also, I havent verified all the instructions.
docs/graphql/manual/schema/default-values/created-updated-timestamps.rst
Show resolved
Hide resolved
docs/graphql/manual/schema/default-values/created-updated-timestamps.rst
Show resolved
Hide resolved
@sezgi please see the changes. |
Review app https://hge-ci-pull-5223.herokuapp.com is deleted |
Description
Add a page on default timestamp values to make this information easier to find for users.
Changelog
CHANGELOG.md
is updated with user-facing content relevant to this PR. If no changelog is required, then add theno-changelog-required
label.Affected components
Related Issues
#2880
Added page
https://deploy-preview-5223--hasura-docs.netlify.app/graphql/manual/schema/default-values/created-updated-timestamps.html