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

Add beginner introduction to Java programming language #172

Open
Aberrantfox opened this issue Nov 20, 2019 · 9 comments
Open

Add beginner introduction to Java programming language #172

Aberrantfox opened this issue Nov 20, 2019 · 9 comments
Labels
flag:good first issue Good for newcomers flag:help wanted Extra attention is needed scope:content Needs content/writeup work

Comments

@Aberrantfox
Copy link

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.

@AstronautEVA
Copy link
Contributor

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.

@Aberrantfox
Copy link
Author

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:

  1. What a declaration is
  2. What a statement is
  3. What a conditional is
  4. What a loop is

These are pretty much the core fundamentals to understand everything. On top of that, there'll probably be some information indicating:

  1. How to install
  2. A selection of editors that might be found to be useful
  3. The main function (if required)
  4. Maybe a demonstration of a slightly more advanced feature

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.

@hbjydev
Copy link
Member

hbjydev commented Nov 22, 2019

@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

@AstronautEVA
Copy link
Contributor

@haydennyyy Issue #48 is a solution to what you are describing

@hbjydev
Copy link
Member

hbjydev commented Nov 22, 2019

@jacquej96 No it's not

@hbjydev
Copy link
Member

hbjydev commented Nov 22, 2019

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.

@AstronautEVA
Copy link
Contributor

AstronautEVA commented Nov 22, 2019

@haydennyyy but couldn't that be done with the issue I linked?
So in the fundamentals article there might be a section describing for-loops. Then there can be a code block of tabs for any language that someone has contributed. Each tab will have the code for the for-loop and explanations of any nuances.

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...")

@hbjydev
Copy link
Member

hbjydev commented Nov 22, 2019

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.

@Aberrantfox
Copy link
Author

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.

@veksen veksen added flag:good first issue Good for newcomers flag:help wanted Extra attention is needed scope:content Needs content/writeup work labels May 12, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
flag:good first issue Good for newcomers flag:help wanted Extra attention is needed scope:content Needs content/writeup work
Projects
None yet
Development

No branches or pull requests

4 participants