pony-tutorial
pony-tutorial copied to clipboard
ponylang
:horse: Tutorial for the Pony programming language
I believe that demonstrating "code best practices" is a general ideal for the tutorial. With the caveat of "unless it blurs the point". I think in the case of the...
We had this sort of on the old tutorial but that didn't get migrated over.
While discussing https://github.com/ponylang/ponylang-website/issues/502 (add quiescence FAQ). - Garbage collector basics (there are 2 entries in the appendix) - Quiescence - ASIO system - Env.exitcode Perhaps a link to runtime options,...
Currently, all information there is on creating code documentation is hidden in [appendices/whitespace.md](https://github.com/ponylang/pony-tutorial/blob/f5e716e9944cbd00d8ca3c8bd0d8129472614f6b/appendices/whitespace.md#docstrings), and only mentions how to add docstrings. This should either be a new section in "Appendices", or...
In https://github.com/ponylang/pony-tutorial/blob/9cfbb3ee7e3e8adbc7b8d914ff440f9482ae8bea/expressions/exceptions.md#comparison-to-exceptions-in-other-languages the pony exceptions are compared to other languages. It is argued that not having error types or instances is better. It would be great to point to some...
> A lambda object is always returned as val if it does not close over any other variables. If it does capture values from the lexical scope then it is...
I'm pretty sure #read isn't in the docs yet, but I couldn't tell by searching. Both examples give a huge number of false positives.
It's been around for a long time as a "beta" sort of feature. It's required for some programs. At this point, I think we need to document it so that...
In the intro to the tutorial, we mention that Pony is deadlock-free. After watching https://www.twitch.tv/videos/378865137, I think its reasonable to assume that many people will interpret that was "livelock" free...
As previously discussed in #210 and #216, there is a need for a compile-time arguments chapter. Currently a few compile-time options are discussed in [Appendices/Compile Arguments](https://tutorial.ponylang.io/appendices/compiler-args.html) (as #210 seeks to...
