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

Tutorial(s) for new programmers #238

Open
byorgey opened this issue Jul 12, 2020 · 4 comments
Open

Tutorial(s) for new programmers #238

byorgey opened this issue Jul 12, 2020 · 4 comments
Assignees
Labels
C-Project A larger project that may take multiple days. S-Critical Critical importance Z-Documentation

Comments

@byorgey
Copy link
Member

byorgey commented Jul 12, 2020

The current tutorial is written with the goal of describing the language as quickly as possible to contributors who are already familiar with functional programming. It is not at all appropriate for new programmers (as many of the target audience will be). We should start writing some much gentler tutorials (with exercises, etc.).

@byorgey byorgey added C-Project A larger project that may take multiple days. Z-Documentation S-Critical Critical importance labels Jul 12, 2020
@byorgey
Copy link
Member Author

byorgey commented Mar 5, 2022

Creating files with comments and code in it, with definitions to be filled in by the user (with accompanying properties) seems to work well.

@byorgey
Copy link
Member Author

byorgey commented Apr 28, 2022

The reference documentation helps somewhat. But after this semester is over, I should start extracting exercises from some of the Discrete assignments I have made (+ creating more), with the goal of being able to use the results in future offerings of the course.

@byorgey byorgey self-assigned this Sep 29, 2023
@byorgey
Copy link
Member Author

byorgey commented Aug 14, 2024

Started working on this in branch docs/introduction.

@byorgey
Copy link
Member Author

byorgey commented Oct 30, 2024

See #406.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C-Project A larger project that may take multiple days. S-Critical Critical importance Z-Documentation
Projects
None yet
Development

No branches or pull requests

1 participant