beam icon indicating copy to clipboard operation
beam copied to clipboard

documentation suggestion: rephrase "creating tables" in Part 3

Open peterbecich opened this issue 1 year ago • 0 comments

My understanding of the purpose of Tutorial Parts 1-3 is to demo successively more complex mappings between the DB and Beam. Can Part 3 rephrase "creating tables" to "creating new table mappings" or something similar to this? https://haskell-beam.github.io/beam/tutorials/tutorial3/

i.m.o. "creating tables" should be held back to describe the Migrations Framework.

The description in the Migrations Framework section helps me to clearly understand that Parts 1-3 do not actually create any tables in the database:

In the User Guide we saw how to declare a schema for an already created database and use it to perform queries. Beam can also manage a database schema based on Haskell datatypes you feed it. The migrations framework is meant to be a robust and modular way of managing schema changes.


As I understand it: Tutorial Parts 1-3 are concerned with Data Query Language and Data Manipulation Language. Migrations Framework is concerned with Data Definition Language. Can we add these phrases?

Thanks

peterbecich avatar Dec 04 '24 07:12 peterbecich