-
Notifications
You must be signed in to change notification settings - Fork 67
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
Add beginner introduction to Java programming language #172
Comments
What kinds of things will the introduction include? Just trying to make sure I don't write an article that would overlap things you cover. |
The beginner articles will be a series of articles for learning a given language as your first language, for each of them there will probably be a minimum requirement of covering:
These are pretty much the core fundamentals to understand everything. On top of that, there'll probably be some information indicating:
For Java, I will probably just demonstrate what an Object is very quickly and then link to the documentation that provides a clearer picture of that. |
@Aberrantfox Idea - Make one article that covers the generic stuff every language has (i.e. loops, statements, declarations, etc.) as like a programming 101, then make an index page for each language that covers the syntax for each of those in that language. In a table or as an article. That way you spend less time explaining each time, and more time teaching that language. I'd be happy to contribute a JavaScript/TypeScript index page if you were to do that |
@haydennyyy Issue #48 is a solution to what you are describing |
@jacquej96 No it's not |
What I'm suggesting is like a "Programming fundamentals" article that explains what each thing is, and then individual posts explaining the nuances & language-specific stuff for each of the separate languages. |
@haydennyyy but couldn't that be done with the issue I linked? This would condense all of the beginner info into 1 article instead of having a for-loop syntax article for every language someone contributes to. (as it appears you suggested in your previous response via "...and then individual posts explaining the nuances...") |
Who said anything about having separate articles for each feature? I meant having one article showing the individual parts that have already been explained in the fundamentals post, just one for each language. Not that declarations, loops and statements should all have separate posts. |
I appreciate what you guys are saying, but I think that this is the programmer mentality kicking into overdrive a little here. It's often useful to prevent duplication, but in this case I think duplication is good. We could have a document describing some general concepts, but I would still say an introductory document that goes over the basis is useful. This will help provide a cohesive flow if someone decides "Okay, I will start out with JavaScript". I would really rather not invent some pseudo-syntax and then teach people to forget that in a starting document. That would just prolong the progress, when it can be better done with real code up front. |
Something that was discussed was a beginner introduction to each language, I volunteered to do the Java one, so I've added this issue to track the feature.
The text was updated successfully, but these errors were encountered: