Okay, your goals are laudable, but the text as it stands now does not help anybody. You said you're looking for suggestions, so here are some (please don't take this criticism personally - everybody has to start somewhere, and everybody makes mistakes. However, if you intend this text to be used as a resource for other people, you have to hold it against a high standard. Especially, if these people trust you.)

First code snippet: I'm not a C++ expert but I'm pretty sure that int[] doesn't have an "append" method. Also, I'm pretty sure that assigning to zero-sized arrays is illegal. I really can't see how this first code example is going to help anybody. It won't run as is, and even if it did - what's the point of this class? (And if you only want to show your comment style: just use ellipses or something, not made-up code that won't work.)

second code snippet: break after return is bullshit. You forgot a close-bracket. The comment says it converts the values 0-2 to words - why is it called checkStatus, then? Also: minor things like calling it "port" in the comment, but "bay" in the code; using ascii chars instead of integers, etc.

throughout the text you just make up terms/concepts that don't exist (for example "static programmer", or "write to mem files") - this isn't going to help beginners. They will google these terms and find nothing. Case in point: I am a programmer, and I don't know what you mean. Use the standard vocabulary.

your explanation of "return" at the end is just wrong. "return" is not a function in JavaScript.

and so on, and so on - really, you have more (big and small) errors in this text than facts.

Please tell your friends to trust at least some resources - stackoverflow, /r/learnprogramming, the language's manual, most books. There are high-quality things out there for absolute beginners. Your text, as it is now, only creates a lot of confusion.

I created this subreddit because it's pretty hard to find
suggestions for programs that make a good read. There's
a wealth of programming-related discussion out there, of
course, but I think that the act of "reading whole programs"
is different/big enough to deserve its own subreddit.

I'm actually quite surprised that people here react so negatively to green-on-black. The only thing that bugs me about his website is that the "shell" doesn't accept input. I actually like those kinds of "non-professional" jokes on personal websites. Didn't realize I'm in such a minority...

Full disclaimer: I, too, have a green-on-black website, including a fake terminal. And a Scheme interpreter. But at least it really works! :)

Where I work, everything code-related is always in English - and we're pretty strict about it. I'm not too sure however, that that's a good idea. We tend to have a lot of "English words but German grammar" stuff in there. Native English speakers wouldn't understand a lot.

I realized that problem only after going through some code written by Russian co-workers. The comments and class names just didn't make any sense at all. I was able to understand the comments after I half-jokingly pulled them through a English->Russian->German Google Translate pipeline. I'm sure they have the same problems with my "English".

We also have nice things like database tables named "categorien" ("category" with a German plural ending) or - very common - ressource/resource mix-ups (the German word for for "resource" is "Ressource").

In documentation, we tend to use German - which, too, isn't optimal. There's a lot of "Der User submitted das Form" stuff going on. We can basically switch to English just by running sed s/der|die|das/the/gi ;-)

I don't have a solution, but it is a real problem. Maybe something mechanical could help - like a code-formatter but for comments and names.

I'm going to use JavaScript and the 2D-Canvas-Context, no WebGL, no libraries. And no audio, probably - I've never done any in-browser audio stuff. Though there might be some time left... Well, or maybe not.

Yeah, the thing is that you have to search the documentation for how to call array_filter() - even if you already know how to call array_map(). Also, the "but it's documented" argument doesn't really work - Malbolge is documented, too. What programming language isn't?

Author here. I agree this post is not /r/programming material. It's just a quick note - a sigh if you will. Others have already noted that I cheated a tiny bit on the function signature, and there are far better articles about the shortcomings of PHP. I don't really have anything new to bring to the party.