moderneinc / moderne-docs

Moderne SaaS documentation as Gitbook contents
https://docs.moderne.io
2 stars 2 forks source link

Expand LST documentation #60

Closed mike-solomon closed 1 year ago

mike-solomon commented 1 year ago

It seems like there is some confusion about how LSTs work. Some key notes:

  1. People were not aware of the fact that LSTs are loaded into memory in fragments rather than all at once.
  2. People were not aware that recipes made changes against the LST rather than against Git (until changes are committed).
  3. People were not aware that if you ran multiple recipes that they would all be run against the existing LST rather than on some changed one. Like if someone ran recipe A and then ran recipe B before committing A, they didn't realize that B would not include the changes from A.

I'm not entirely sure where we should clarify these things, yet -- or what else we might want to say on this topic -- but I wanted to document this for now.

Related Slack thread