search

tursodatabase / turso-docs

Turso Documentation
https://docs.turso.tech
MIT License
11 stars 49 forks source link

Add section on creating a database #99

Closed penberg closed 9 months ago

penberg commented 1 year ago

First time users in particular don't need to know about placement groups to get going. Add a short section on how to just create a database.

Reported by Jan Piotrowski

vercel[bot] commented 1 year ago

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
turso-docs ✅ Ready (Inspect) Visit Preview Sep 29, 2023 8:28am
CodingDoug commented 1 year ago

This problem with this is that creating a database necessarily creates the default placement group first (you don't start with a default placement group), which is covered just below. You can't have a database without a placement group. That's what the following section tries to clarify. In fact, the CLI will tell you that this happened automatically, and is an important detail to be aware of going forward.

The only way I personally have been able to make long-term sense of database creation is within the context of a placement group, so I don't feel like skipping that concept prior to database creation supports that long-term understanding.

Also, right now in the reference docs, all of the database creation option variants are clustered together in the same section, and having outside of that feels odd. The entire section on placement groups with database management is meant to be read sequentially for maximum comprehension).