You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
There is insufficient explanation where a developer should use create versus insert or live versus subscribeLive. Please add a paragraph that disambiguates when and why a developer should pick one over the other in the documentation -- as it stands now it's unclear when a developer should pick one over the other. It's somewhat more clear for subscribeLive but it's still decently blurry to the unfamiliar developer -- adding a "use case" section would make it more clear where and when to use it.
Notably, there are differences in functionality where db.insert throws an error if provided a RecordId object, and db.create handles that with no error.
Description
There is insufficient explanation where a developer should use
create
versusinsert
orlive
versussubscribeLive
. Please add a paragraph that disambiguates when and why a developer should pick one over the other in the documentation -- as it stands now it's unclear when a developer should pick one over the other. It's somewhat more clear forsubscribeLive
but it's still decently blurry to the unfamiliar developer -- adding a "use case" section would make it more clear where and when to use it.Notably, there are differences in functionality where db.insert throws an error if provided a RecordId object, and db.create handles that with no error.
https://surrealdb.com/docs/sdk/javascript/methods/create
https://surrealdb.com/docs/sdk/javascript/methods/insert
https://surrealdb.com/docs/sdk/javascript/methods/live
https://surrealdb.com/docs/sdk/javascript/methods/subscribelive
Is there an existing issue for this?
Code of Conduct
The text was updated successfully, but these errors were encountered: