Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update tutorial with recent syntax changes #7242

Open
9 tasks
JanCVanB opened this issue Nov 22, 2024 · 5 comments
Open
9 tasks

Update tutorial with recent syntax changes #7242

JanCVanB opened this issue Nov 22, 2024 · 5 comments
Labels
website www.roc-lang.org

Comments

@JanCVanB
Copy link
Collaborator

JanCVanB commented Nov 22, 2024

I've already started editing tutorial.md locally, but I'm creating this to track the variety of changes we need/want:

(sorted by first impacted location in tutorial)

  • Minimize !" use in example strings, to help effectful function names pop and prevent exclamation fatigue
  • Bump dependencies to the best ones for December (frozen during AoC)
  • Update main =s to main! = \{} ->s
  • Update Stdfoo.bars to Stdfoo.bar!s
  • Explain early return (return)
  • Explain early error return (try)
  • Explain effectful functions (!)
  • Explain effectful function type (=>)
  • Remove Tasks section and all references to task-related vocabulary

PR coming soon!

@JanCVanB
Copy link
Collaborator Author

I wonder how many days before AoC 1% of participants start learning a new language.

@ErikFeeley
Copy link

I am not new to the language but I had thought about freshening up on Roc as early as a week or two ago when thinking about using it for AoC this year.

@JanCVanB
Copy link
Collaborator Author

@ErikFeeley Thank you! That's helpful to know. If you want, I can ping you again next week for feedback on the updated tutorial. 🙂

@fpsvogel
Copy link

I am new to the language, except for a read-through of the tutorial a couple months ago, after which life got busy and now I'm coming back to give Roc a proper try (pun intended).

Thank you for working on the tutorial! If you want feedback from a newbie, let me know.

@skyqrose skyqrose added the website www.roc-lang.org label Nov 24, 2024
@ErikFeeley
Copy link

@JanCVanB sounds good but no worries! I am honestly not sure how much time I'll get to dedicate to AoC this year. But I'll try to give some feedback if I get around to giving it a go :).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
website www.roc-lang.org
Projects
None yet
Development

No branches or pull requests

4 participants