search

pyos / dg

A programming language for the CPython VM.
http://pyos.github.io/dg/
MIT License
576 stars 20 forks source link

Misguide in documentation (return values) #37

Open ceremcem opened 7 years ago

ceremcem commented 7 years ago

There is a misguide in documentation:

image

This function is obviously expected to return 4 (as the first line in the screenshot says) but the function name (definitely_not_4) is misleading: 

definitely_not_4 = x ->
    x + 2
    4

print <|  definitely_not_4 40  #=> not 4

and it definitely returns 4:

image

...in contrast with the function name.

refi64 commented 7 years ago

I think that was supposed to be humor...

ceremcem commented 5 years ago

...a little bit too much humor for a documentation. I just got it :rofl:

pyos commented 5 years ago

Yeah, the tutorial is supposed to be a bit tongue-in-cheek, as the fake O'Reilly cover might suggest. Kind of hints that the project is not particularly serious, no? (Probably didn't age well, though.)