Epilogue
EdgeDB renamed to Gel at some point and was later absorbed into Vercel in December 2025.
Requests from Yury
- Document default values for query params Todo
- Make documentation snippets runnable (TS and EdgeQL) Todo
- Can only work against a pre-defined schema (movies schema in interactive tutorial)
- Change most queries to run against that schema
- Start working on it to see how much work it will be
- Selects, inserts, updates
- Not every one has to be runnable
- Schema: https://github.com/edgedb/edgedb.com/blob/master/content/tutorial/dbschema/schema.esdl
- Data: https://github.com/edgedb/edgedb.com/blob/master/content/tutorial/dbschema/migrations/00002.edgeql
- Backfill StackOverflow answers Todo
- Reverse-engineer and document CLI config file Todo
.config/edgedb/cli.toml- See https://edgedb.slack.com/archives/CNECHA9EW/p1692904735119089
- https://github.com/edgedb/edgedb-cli/blob/master/src/config.rs#L12-L52
- Make a DX project on GitHub
- Add all of my to-dos to it
- Move add other high-priority user-facing tickets to it
- https://github.com/orgs/edgedb/projects/31/views/1
- Add a guide for exposing your GitHub org to EdgeDB Cloud
- Explanation and video here: https://edgedb.slack.com/archives/CRTJN2FJ8/p1693849853359659?thread_ts=1693849560.540679&cid=CRTJN2FJ8
Todo
- Document how to tell the result of an upsert (
updateorinsert) Todo- Here’s a query that will do it:
select (
insert Person {name := 'Test', phone := '123456789'}
unless conflict on (.name) else (
update Person set {phone := '123456789'}
)
) {is_new := (select not exists (select Person filter .name = 'Test'))};
name is exclusive here. Your query isn’t really an upsert since there’s no update, but you could use the same technique there too, I believe. This leverages the fact that, since everything here happens in a single transaction, the Person will not be found with a select if they are inserted with this query and checks for that with the computed is_new.
- Document advanced migration workflows Todo
- Editing
- Squashing
- Add case insensitivity mutation rewrite example Todo
- Give guidance for migration merge conflicts Todo
- Document Deno pre-requisites in web site documentation Todo
- Add info on how to get type in polymorphic queries Todo
- Add here: http://www.edgedb.com/docs/edgeql/select#polymorphic-queries
- Try something like this:
select MyAbstractType {__type__: {name}};or if you need it at the top level, you can do this:select MyAbstractType {type := .__type__.name};
- Show filtering on enums in the TS docs Todo
- Make an example schema that incorporates all EdgeDB features Todo
- Update
docs/edgeql/types.rstto reflect IDs can be cast into object types. Todo- Current text: “Type casts can only be used on primitive expressions, not object type expressions. Every object stored in the database is strongly and immutably typed; you can’t simply convert an object to an object of a different type.”
- See https://www.edgedb.com/docs/stdlib/uuid#type::std::uuid
- Might also be worth mentioning in the type cast operator docs: https://www.edgedb.com/docs/stdlib/type#operator::cast
- Note on all
edgedb projectandedgedb instanceCLI commands that they are not for production instances Todo - Distribute awesome repo Todo
- Promote in list of awesome repos
- work with Sully on putting together a list of quirks to be documented Todo
- Focus on link properties, grouping, and tuple properties
- See https://discord.com/channels/841451783728529451/1133495880230637729/1133830877210742935
- See https://github.com/edgedb/edgedb/issues/created_by/abecciu
- Documented quirks of link properties
- Document
forconditional hack Todo - Make instructions for migrating on production easier to trip over Todo
- Add more group examples Todo
- Write a guide for programmatically reimplementing our migrations tooling Todo
- Document underlying implementation of all CLI commands Todo
- Check the votes on Ask AI questions and see if we can fix anything Todo
- Document temporal database Todo
- Document filtering, limiting, ordering links Todo
- Document when to use different methods of constraining Todo
- proper constraints vs. trigger/assert vs. access policy
- See https://discord.com/channels/841451783728529451/849377751370432573/1121211414045012009
- Document query analysis metrics Todo
- Elvis describes some of them here: https://edgedb.slack.com/archives/CNECHA9EW/p1686929289666499
- Write a guide to share Scott’s solution to
unless conflictonidfield Todo- Workaround for
UNLESS CONFLICT can not use ELSE when constraint is from a parent typewhen usingunless conflicton anidfield (or others on a parent)
- Workaround for
- Explain JSON best practices Todo
- Document using Cloud with CI Todo
- Update the advice on instance size in the DO deployment guide to 2GB or 1GB plus managed postgres Todo
- Note that it isn’t possible to parameterize
order byexpression Todo - Document how to check current configuration Todo
- Add issue template to
edgedb-uirepo Todo - Reach out to JetBrains DataGrip team about building syntax highlighter Todo
- Update AWS CF template to share a single certificate Todo
- Issue: https://github.com/edgedb/edgedb-deploy/issues/19
- See https://discord.com/channels/841451783728529451/849377751370432573/1098477739234840636
- We should also instruct them to supply their own TLS key: https://discord.com/channels/841451783728529451/849377751370432573/1106246549211717662
- Messaged Fantix to ask how we move forward on this: https://edgedb.slack.com/archives/D04DFFTQ7KJ/p1684264878166809
- Seems like we will want to rework the CF template to generate and share a single certificate to get around this. Frederick will tackle it once Cloud work has slowed.
- Add links to Dart, Rust, .Net, and HTTP clients in Get Started > Overview (docs/intro/index) Todo

- Will require new icons for those libraries
- Existing icons are in web site repo at
components/docs/docsNavTable/icons.tsx - Table to update to add new items is in web site repo at
components/docs/docsNavTable/index.tsx - Messaged about this on Slack: https://edgedb.slack.com/archives/CABMSADD3/p1684426046337229
- Document introspection of globals Todo
- Add
EDGEDB_DOCKER_APPLY_MIGRATIONS(from the Docker schema migrations docs) andEDGEDB_SERVER_HTTP_ENDPOINT_SECURITYto the list of environment variables Todo- See https://discord.com/channels/841451783728529451/1058029984486273108/1058062043653091338
- See https://edgedb.slack.com/archives/CNECHA9EW/p1676560655737649
- Can reference https://github.com/edgedb/edgedb-docker/blob/master/docker-entrypoint-funcs.sh to find all undocumented Docker env vars.
- Update documentation to address tuple operations Todo
- adding an element to a tuple
- removing an element from a tuple
- filtering based on values in a tuple
- See https://discord.com/channels/841451783728529451/841451783728529454/1050466148526854214
- See https://discord.com/channels/841451783728529451/849377751370432573/1050450419236737045
- Make information about how booleans work (
orshort circuit breaks with properties that have empty set) easier to trip over Todo- See [[EdgeDB tools meeting 2023-04-05#or-behavior|
orbehavior]] - Note user can use
?=for values that could be empty - Include this the first place we introduce filtering (and everywhere that talks about filtering)
- Can link to Working with booleans — Cheatsheets | EdgeDB Docs
- See [[EdgeDB tools meeting 2023-04-05#or-behavior|
- Document that checking a bool property in querybuilder will always result in
trueTodo - Explain the difference between
whenandusingin access policies Todo - Clarify nature of aliases and why you can shape them in ways that include properties not in the original alias Todo
- Document selecting an object via a known backlink Todo
- Document the UI Todo
- including noting that it is off by default for non-local instances
- link to
edgedb uidocs
- Write a guide for managing a production instance Todo
- Document using EdgeDB with a monorepo Todo
- See https://discord.com/channels/841451783728529451/1059108950311714887/1059872062287642664
- See https://discord.com/channels/841451783728529451/849374705210490900/1055336289081241650
- More generally, document with different project topologies
- Write a guide for making EdgeDB server high availability Todo
- This is not about high availability for Postgres which is a separate thing.
- See https://discord.com/channels/841451783728529451/1092827167836082176/1093216258612281444
- Mine Dave’s onboarding notes to see what improvements I can make Todo
- Improve documentation of
errmessagefor constraints Todo - Document savepoint nesting behavior and recommend unique names Todo
- Better explain limitations of constraints Todo
- Add updating nested link properties example to Update and client library update documentation Todo
- See https://discord.com/channels/841451783728529451/849374705210490900/1072916391667183746
- https://www.edgedb.com/docs/edgeql/update
- https://www.edgedb.com/docs/clients/js/update
- Maybe other client libraries as well
- Test development mode in CLI Todo
- Document Go generator Todo
- See https://github.com/edgedb/edgedb-go/blob/master/cmd/edgeql-go/doc.go for CLI documentation
- See https://edgedb.slack.com/archives/D047Z3DJVL4/p1670599575918199 for an additional note that should be added to the documentation
- Blocked by Generate documentation for Go code generator · Issue #3 · edgedb/website · GitHub
- Integrate Rust docs into web site Todo
- Add more guidance around transactions with respect to serialization, data layout, retrying, and slow operations in transactions Todo
- Make a performance guide Todo
- See 24 tools meeting
- Remove paragraph from links docs about single vs. multi performance
- Useful comment on query performance with reply from Elvis- https://discord.com/channels/841451783728529451/841451783728529454/1137167465000992969
- 3-minute video covering contributing to the documentation on YouTube Todo
- blog post around documentation tooling Todo
- Document how to test an app that uses EdgeDB Todo
- Document syntax notation in documentation Todo
- Update Remix example application Todo
- Add UUID shortener example project Todo
- See https://edgedb.slack.com/archives/D047Z3DJVL4/p1669058787163219
- Users want a shorter unique ID for slugs
- They think they would have to create another ID field but they could generate a shorter ID instead
- Write a guide for backendless with GraphQL
- This isn’t really possible right now without auth
- User request: https://github.com/edgedb/edgedb/discussions/5468#discussioncomment-5874536
- Asked for help with this on Slack: https://edgedb.slack.com/archives/CNECHA9EW/p1683822295306279
Done
- Make delegated constraints more visible in docs Todo
- Explain why
create databasecannot happen in block/transaction Todo- Add here: docs/reference/environment.rst
- See https://edgedb.slack.com/archives/CNECHA9EW/p1686060226716759
- Go live with showcase Todo
- Clarify the Cloud guide Todo
- Deployment
- When to use
edgedb project initvsedgedb instance create
- Bring Elixir docs into our documentation Todo
- Add note about inaccuracies to Ask AI Todo
- Research US conference talk opportunities Todo
- Devon, can you do a quick research on what conferences we can potentially go and deliver talks and whatnot (i can do the talks). Specifically conferences in the US, like GitHub Universe, or maybe some specific ones about SaaS products or databases
- Ideally we should have a spreadsheet projecting for one year into the future and consider going or joining panels/delivering talks
- Started working on this. Results on Notion https://www.notion.so/edgedb/76cea19ce8284cbdaf6d44a2fa1c1252?v=c0022ff0fa774614857b86ce8c778bac&pvs=4
- Note that link properties cannot be link links Todo
- Document how to recover migration files Todo
- Document
edgedb database wipeTodo - Look for other documentation that divides search by library Todo
- collect maybe 10 examples (if I can find them)
- Generate some wireframes or text for a faceted search design Todo
- Publish documentation blog post 8/3 or 8/10 Todo
- Form a plan around the hackathon Todo
- Update note on triggers about mutations since they are finished now Todo
- Update bare metal deployment guide Todo
- See https://edgedb.slack.com/archives/CNECHA9EW/p1685527561807589
- Paul says the setting for
--unix-pathshould be found in the system.d file - Also https://edgedb.slack.com/archives/D04BU6YCKK7/p1686750170332989
--runstate-dirtakes precedence over theEDGEDATAenv var- Slack thread: https://edgedb.slack.com/archives/CNECHA9EW/p1689006603724349
- PR: https://github.com/edgedb/edgedb/pull/5760
- Document edgedb.toml Todo
- Move Elixir to official libraries on libraries page Todo
- Document accessing different modules in TS query builder Todo
- Use
e.<module-name>.<type-name> - PR: https://github.com/edgedb/edgedb-js/pull/609
- Use
- Document
edgedb cloudTodo- See https://edgedb.slack.com/archives/D04DFFTQ7KJ/p1683817066031409
- Cloud CLI experience thread: https://edgedb.slack.com/archives/CRTJN2FJ8/p1682013916321729
- Document empty set limit (to effectively set no limit) Todo
- See https://github.com/edgedb/edgedb/issues/5485
- I thought I understood the use case for this but maybe I don’t. I though the use case was, “I parameterize my limit, and now I need to turn off that parameterized limit temporarily.” That doesn’t seem to work though, at least in the REPL.
- My understanding was correct, but I must make the parameters optional in order to be able to pass the empty set to them.
- PR: https://github.com/edgedb/edgedb/pull/5507
- GraphQL docs mention 2.0 in future tense Todo
- Document float to int casting rounds Todo
- Link to type intersections from select documentation Todo
- Note that WSL is required under Windows because EdgeDB server runs under linux Todo
- Fix typo on JS client docs Todo
- Fix computed example in docs Todo
- Fix minor bugs in FastAPI example Todo
- Document optional query arguments Todo
- Document Postgres/EdgeDB limits on str and jsonb types Todo
- Update paragraph suggestion that didn’t get merged with previous PR Todo
- See PR: https://github.com/edgedb/edgedb/pull/4881#issuecomment-1471887808
- Suggestion for lines 27-32:
If any of the above criteria is not met, we usually provide a custom type in
the client library itself that can be converted to a type from the language's
standard library or from a popular third-party library. Exception: The
JavaScript ``Date`` type (which is actually a timestamp) has millisecond
precision. We decided it would be better to use that type by default even
though it doesn't have sufficient precision.-
Document documentation Todo
- custom directives
- flesh out style
- Tweet about it and emphasize with the community once this is done
-
Add
edgedb uiand options to the docs Todo -
Document
allow_bare_ddlandapply_access_policiesTodo -
Remove mention of
limitwith regard toupdatein JS docs Todo -
Update NextJS guide video Todo
- In review
- Waiting for new intros and thumbnails to go live
-
Add TS querybuilder examples of
e.forTodo -
Change documentation to tell users to install QB generator instead of running via
npxTodo- See https://edgedb.slack.com/archives/CNECHA9EW/p1671488065449729
- PR pending: https://github.com/edgedb/edgedb/pull/4841
One more PR I still need to get in on the simpletodo repo so that has the generator installed.
-
Document volatility of datetime functions Todo
datetime_of_statement()is non-volatile and safe for computed properties;datetime_current()is notstatementindatetime_of_statement()means the query. Does not compute multiple times in afor- See https://discord.com/channels/841451783728529451/849377751370432573/1053294144564506654
- PR in review: https://github.com/edgedb/edgedb/pull/4842
-
Update MCU dataset Todo
- See https://edgedb.slack.com/archives/D048L5LN797/p1668805911155079
- Changes are in and committed locally (albeit to the
masterbranch; might need to back that out and submit on another branch if I don’t have push tomaster) - Don’t have write permissions on the repo. Need to ask Elvis if he can grant me permissions.
-
Link to upsert tutorial from upsert documentation Todo
-
Update generator command in the Heroku guide Todo
-
Document opening last REPL query in editor with
\eTodo -
Update FastAPI guide to use code generator Todo
-
Update CLI disable version check docs Todo
- Should be
EDGEDB_RUN_VERSION_CHECK=neverinstead ofEDGEDB_NO_VERSION_CHECK=true - See https://discord.com/channels/841451783728529451/849377751370432573/1051805760230789121
- Should be
-
Document that you cannot run
edgedb-serveras root Todo -
Add contributing guidelines around docs Todo
- See this conversation thread: https://edgedb.slack.com/archives/C01SYGCDGFN/p1669926165769789
- Draft PR in: https://github.com/edgedb/edgedb/pull/4761
Development
Marketing
- EdgeDB 3.0 release launch marketing plan
- EdgeDB 3.0 query performance analysis talk at live launch event
- EdgeDB v5 2024-03-28 launch plan
Learning
DX
Feature Testing
Content
New
- EdgeDB documentation on documentation
- EdgeDB 3.0 initial documentation
- EdgeDB 3.0 beta announcement
- EdgeDB 3.0 changelog
- We Are FancyQL blog post for EdgeDB
- EdgeDB Fiori blog post
- EdgeDB Cloud Vercel deployment guide
- EdgeDB Cloud Netlify deployment guide
- EdgeDB Cloud resize UIs and log UI
- EdgeDB blog post Andrea Zorzetto
- EdgeDB Cloud instance creation copy
- EdgeDB 5.0 documentation
Tricky Messaging
Video
Reviews
- EdgeDB documentation review
- EdgeDB observations 2022-09-27
- The graph-relational database, defined review
- Bringing .NET to EdgeDB review
- EdgeDB Release Candidate 2 review
- Building a simple blog application with EdgeDB and Next.js review
- Building a REST API with EdgeDB and FastAPI 11-2022
- Building a REST API with EdgeDB and FastAPI 01-2023
- EdgeDB Standard Library docs review
- Easy EdgeDB book review
- EdgeDB fly.io deployment guide review
- EdgeDB docs 2024-02-29
User Feedback
Web Site
Watering Holes
- Building a production database in ten years or less | Hacker News- A HackerNews post of a blog post Yury wrote
Meetings
- EdgeDB call with Aleksandra 2024-04-01 on getting started videos
- EdgeDB call with Devpost re v5 hackathon
- EdgeDB one-to-one with Yury 2024-03-19
- EdgeDB one-to-one with Yury 2023-06-13
- EdgeDB one-to-one with Yury 2023-01-24
- EdgeDB call with Victor re durations and reword PR
- EdgeDB dev rel continuity meeting with Colin McDonnell
- EdgeDB Onboarding with Yury Selivanov 2022-10-26
- Michael Sullivan (Sully)
- Dijana Pavlovic
- EdgeDB Aleksandra Sikora onboarding meeting
- EdgeDB Blog post call with Riley of Dexa
- EdgeDB call with Aleksandra 2024-02-12
- EdgeDB call with Aleksandra 2024-02-20
- EdgeDB call with Aleksandra 2024-02-27
- EdgeDB call with Aleksandra 2024-03-04
- EdgeDB customer interview call with sane.fyi
Dev Rel Calls
name Add dev rel call log
type command
action QuickAdd: New EdgeDB dev rel meeting
color greendv.list(dv.pages('"logs/EdgeDB dev rel meetings"').sort(page => page.file.ctime, 'desc').file.link)Tools Calls
name Add tools call log
type command
action QuickAdd: New EdgeDB tools meeting
color greendv.list(dv.pages('"logs/EdgeDB tools meetings"').sort(page => page.file.ctime, 'desc').file.link)Web Site Calls
name Add web site call log
type command
action QuickAdd: New EdgeDB Web Site Meeting
color greendv.list(dv.pages('"logs/EdgeDB web site meetings"').sort(page => page.file.ctime, 'desc').file.link)Team Chats
name Add team chat log
type command
action QuickAdd: New EdgeDB Team Chat Meeting
color greendv.list(dv.pages('"logs/EdgeDB team chat meetings"').sort(page => page.file.ctime, 'desc').file.link)Not Linked Here
EdgeDB related notes not linked in this topic note
dv.list(dv.pages('"Devon/notes"').where(note => note.file.name.toLowerCase().includes('edgedb') && !note.file.inlinks.includes(dv.current().file.link)).sort(page => page.file.ctime, 'desc').file.link)