pkl icon indicating copy to clipboard operation
pkl copied to clipboard

Language tutorial "Writing a Template" is confusing sometimes

Open gtirloni opened this issue 1 year ago • 1 comments

This whole section talks about pklTutorialPart3.pkl which had not been defined up to that point. Additionally, it's talking about types and classes and then shows an example of amending that has no classes (TutorialPart.pkl and pklTutorialPart3.pkl).

It goes on to say:

This now behaves exactly like our pklTutorialPart3: TutorialPart = (pklTutorialPart1) {…​ before. pklTutorialPart3 is now defined as the value we get by amending tutorialPart and giving it a name and a part

Ok, it behaves exactly like that so then what's the point of using a class (I know the point, I don't understand why the tutorial is going down this path).

gtirloni avatar Oct 27 '24 20:10 gtirloni

Thanks for the feedback! We'll look to improve the tutorial. But, also, feel free to submit a pull request with changes that you think would be more helpful.

bioball avatar Nov 01 '24 03:11 bioball