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
Our current documentation has some great content and great examples of using Dolt. It would be really cool if we could take it a step further and instead of just "reading" the documentation and examples, people could interact and experience Dolt. For example, on the system table references page, we have a lot of good, concrete examples on using Dolt's versioning features, but it would be more interactive and compelling if people could really run the queries themselves in DoltHub, change query values, and explore what Dolt can do. I think the system tables, functions, and procedures references would be natural places to start, but you could imagine this being used in many other places in the docs, too. Having something in a getting started experience doc would also be really great. Maybe even something we could re-use for blogs eventually?
Something like this could help Dolt customers more quickly understand how to use Dolt features and could help people brand new to Dolt quickly see the Dolt experience more deeply and get it under their fingers.
The major challenges I see with this are that some queries are going to run very slowly on DoltHub, either because of query slowness (which we should fix) or because of the latency for DoltHub to load a database (one way to get around this may be to allow list a set of "documentation" databases that we keep loaded somehow?). It will also be important that these queries consistently work over time – having a customer see the interactive experience and see it broken would be a really bad experience, so we'd want to be smart about building this in a way where we proactively learn if we broke something with a code change.
The text was updated successfully, but these errors were encountered:
Our current documentation has some great content and great examples of using Dolt. It would be really cool if we could take it a step further and instead of just "reading" the documentation and examples, people could interact and experience Dolt. For example, on the system table references page, we have a lot of good, concrete examples on using Dolt's versioning features, but it would be more interactive and compelling if people could really run the queries themselves in DoltHub, change query values, and explore what Dolt can do. I think the system tables, functions, and procedures references would be natural places to start, but you could imagine this being used in many other places in the docs, too. Having something in a getting started experience doc would also be really great. Maybe even something we could re-use for blogs eventually?
Something like this could help Dolt customers more quickly understand how to use Dolt features and could help people brand new to Dolt quickly see the Dolt experience more deeply and get it under their fingers.
The major challenges I see with this are that some queries are going to run very slowly on DoltHub, either because of query slowness (which we should fix) or because of the latency for DoltHub to load a database (one way to get around this may be to allow list a set of "documentation" databases that we keep loaded somehow?). It will also be important that these queries consistently work over time – having a customer see the interactive experience and see it broken would be a really bad experience, so we'd want to be smart about building this in a way where we proactively learn if we broke something with a code change.
The text was updated successfully, but these errors were encountered: