Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

documentation suggestion: rephrase "creating tables" in Part 3 #728

Open
peterbecich opened this issue Dec 4, 2024 · 0 comments
Open

documentation suggestion: rephrase "creating tables" in Part 3 #728

peterbecich opened this issue Dec 4, 2024 · 0 comments

Comments

@peterbecich
Copy link
Contributor

peterbecich commented Dec 4, 2024

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant