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

Rewrite initial Thema tutorial to focus on just basic schema authoring, then pivot to codegen right away #74

Closed
sdboyer opened this issue Oct 18, 2022 · 0 comments · Fixed by #78
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@sdboyer
Copy link
Contributor

sdboyer commented Oct 18, 2022

Thema's existing tutorial (parts 1, 2, and 3) is outdated and overly verbose.

All of part 2 and most of part 3 are now now pretty much done by codegen (thema lineage gen). thema lineage gen gobindings with --bindtype even goes a step beyond part 3, thanks to generics and the new vmux system.

I think a new pass at the tutorials should focus on getting a basic thema-based dev loop going: write a schema, update types and bindings in Go and TS, test with some data.

Subcommands within thema lineage init, thema lineage gen, thema data validate should be sufficient for all this. We can, for now, ignore multiple schemas and lenses.

Some of what's in the existing tutorials could probably be reused, but if we just started from scratch, i wouldn't be unhappy 😄

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
2 participants