Skip to content
GitLab
  • Menu
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • sac2c sac2c
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 403
    • Issues 403
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 12
    • Merge requests 12
  • Deployments
    • Deployments
    • Releases
  • Wiki
    • Wiki
  • External wiki
    • External wiki
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
Collapse sidebar
  • sac-group
  • sac2csac2c
  • Issues
  • #2311
Closed
Open
Created Mar 15, 2022 by Spencer Bliven@sbliven

Improve jupyter docs

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?
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information
Assignee
Assign to
Time tracking