xtdb

esp1 2024-10-11T16:18:22.601499Z

fyi the links to xt/execute-tx and xt/submit-tx at the top of https://docs.xtdb.com/reference/main/xtql/txs.html are broken

refset 2024-10-11T16:24:24.596689Z

ah, thanks for mentioning that! in the meantime you can find the codox page here: https://docs.xtdb.com/clients/clojure/codox/xtdb.api.html#var-execute-tx

👍 1
esp1 2024-10-11T16:25:10.876229Z

also as a more general note, I found the documentation a bit hard to follow, especially at first. There aren't many examples of how transactions/queries are actually called, and since query operations use symbols instead of keywords, it took me a while to realize that those needed to be quoted.

esp1 2024-10-11T16:29:00.413189Z

It might be nice to include some more high level description of how query/transaction execution is expected to work at the top somewhere. Some discussion on the rationale behind the api would also be helpful I think. For instance, I am curious what the rationale was for using symbols for query operators?