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

Suggested improvements #54

Open
jlp765 opened this issue Aug 26, 2017 · 1 comment
Open

Suggested improvements #54

jlp765 opened this issue Aug 26, 2017 · 1 comment

Comments

@jlp765
Copy link

jlp765 commented Aug 26, 2017

Suggestions only:

  • Add a chapter on single/multi line comments (or maybe do it as part of Hello World chapter(?)
  • Chapter If, Else, While be changed to If, Elif, Else, While
  • Chapter For Loops & Iterators have addition of mitem & mpair, to show how to use modifiable iterators.
  • Add module importing, module aliasing, including files, etc
  • Chapter Procs, add example of discardable proc calls and pragma.
  • Chapter Objects should probably include a linked list example, to show a common usage of mutually-recurring types. Also add an example of Object Variants
  • Add Procedural Type chapter and show an example of an array of proc pointers (or jump-table equivalent)
  • Chapter Strings add some examples of slicing/concat/delete/... that can be performed with strings, and mention strutils and some other string-related modules for further reading
  • Add **File and IO" Chapter with system based open/close/FileExists/read/readLine/Line Splitting/.... and also mention parsing modules like parseCSV and also memfiles
  • Add Parallel and Concurrency chapter to cover this and also Asynch modules (or point to where info can be found)
  • Add Exception Handling chapter, covering try..except..finally, and raise, etc Defining your own exceptions. Maybe worth covering the "Effect System" for procs
  • Add examples of an auto type (as part of an existing Procs chapter, or as its own chapter?)
  • Add Tuple Types chapter (or as part of Object Types chapter?)
@flaviut
Copy link
Owner

flaviut commented May 1, 2018

Wow, thank you for this great list of improvements! I didn't see this until now, but I'll try to work on it when I can.

Of course, I'd greatly appreciate community involvement 😄.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants