sac2c issueshttps://gitlab.sac-home.org/sac-group/sac2c/-/issues2022-03-21T21:40:34Zhttps://gitlab.sac-home.org/sac-group/sac2c/-/issues/2311Improve jupyter docs2022-03-21T21:40:34ZSpencer BlivenImprove jupyter docsI'm a new SaC user. After going to the home page the first thing I did was open the jupyter notebook and start copying code from the home page and the tutorial. This fails for reasons that I'm sure are obvious to seasoned SaC developers ...I'm a new SaC user. After going to the home page the first thing I did was open the jupyter notebook and start copying code from the home page and the tutorial. This fails for reasons that I'm sure are obvious to seasoned SaC developers but it was frustrating to get many compile errors before I started figuring SaC out.
Would it be possible to add a page explaining the rules behind jupyter? Or even better, add a jupyter version of the tutorial as an example.
Some of the dumb things that threw me:
- When to use semicolons. Why does `print(1);` compile but `1+1;` does not?
- Why do side effects from previous cells occur during execution?
- Why can't I create a main function? All the tutorial examples are wrapped in main() so they can't be trivially copy-pasted to jupyter.
- When do cells get compiled?