[Not a PR] Reaction to the tutorial

[theo-m]

Cool tutorial! It shows a good picture of what to expect and what it's meant for. Perhaps having the full file linked somewhere to get a sense of what it looks like with the legal text would be helpful.

Mostly nitpicking, but:

• "algebraic data type" is a barbarism that isn't welcome - in my opinion, it's better to gradually introduce abstractions when they're needed.
• showing error outputs would help contextualize things, perhaps out of scope for a tutorial?

[theo-m]

Feel free to close anytime btw!

[EmileRolley]

Hi @theo-m,

Thanks for your feedback!

Perhaps having the full file linked somewhere to get a sense of what it looks like with the legal text would be helpful.

I'm not sure what you mean by that. Do you mean having a link to the tutorial.catala_en file or having real world example, such as the French family benefits computation?

Mostly nitpicking, but:

• "algebraic data type" is a barbarism that isn't welcome - in my opinion, it's better to gradually introduce abstractions when they're needed.
• showing error outputs would help contextualize things, perhaps out of scope for a tutorial?

For the rest, I'll let @denismerigoux answer you :)

[denismerigoux]

Thanks @theo-m !

"algebraic data type" is a barbarism that isn't welcome - in my opinion, it's better to gradually introduce abstractions when they're needed.

It's actually the precise name for the thing I was explaining in simple terms in that sentence. But if you think that may scare new users, I'm fine with removing it :)

showing error outputs would help contextualize things, perhaps out of scope for a tutorial?

Yep now we have full pandoc markdown support for the non-Catala parts so we can pretty-print error outputs in the tutorial !