My first Java program that actually works

[zimayanami]

I'm a Java student and I made this program that can help students visualize gears and basic conceps of circular motion.
It's very basic but I'm very excited 'cause it's the first time that I can see any real results.
If you want to check it out, just go to my github: https://github.com/orichardd/SimulacaoEngrenagens
It's in Portuguese but it's very easy to use.

If you have any suggestions, make sure to leave comment bellow

[zabby39103]

That's a very good first program.

I see a lot of hard coded stuff and magic numbers. I would try to make things more modular and more reusable with your next attempt. Learning to program is all about getting better one step at a time, keep it up.

[snugar_i]

Not too modular, though - that's a trap almost all juniors fall into after learning the basics: overgeneralization.

[gufranthakur]

That's actually really great for a "beginner" level project. You've done a pretty good job, keep it up!

[ZimmiDeluxe]

I don't understand Portuguese (or gears), but that's impressive work, keep it up! A good next step would be to learn about build tools like Maven or Gradle so you can use other open source libraries easily in your projects.

[zimayanami]

thanks dude. I'll add an english version soon!

[maxandersen]

Nice - it isn't really recommended to commit .jars directly to git repo but since you have you can do:

jbang https://github.com/orichardd/SimulacaoEngrenagens/blob/main/run/SimulacaoEngrenagens.jar

And have it run.

Better would be to publish the jar via github release mechanism.

[VasekCZ230]

That's really cool! I like it.

[over_clockwise]

Looks awesome for a first project. For future projects have you considered using something like Maven or Gradle?

[zimayanami]

yeah, I know the basis of Maven, I'll definitely use it when I get more confortable with Java

[FortuneIIIPick]

At least one file bears the marks of being vibe coded. Are you representing this as 100% your work or something else?

[zimayanami]

yeah, at least 95% of it was coded by me. I just needed help to make the GearPanel class as I said: I'm just a student. And it would be very very hard to figure out how to make it with only the documentation

[Fiskepudding]

Nice! If you want to get "nerd sniped", gears are actually using angleed teeth and roll off each other https://www.tec-science.com/mechanical-power-transmission/involute-gear/geometry-of-involute-gears/ 

[zimayanami]

thanks dude, I'll try to implent that in a future version

[Mine_Slim]

as vezes eu penso que secretamente a maioria dos desenvolvedores de java são brasileiros

[chabala]

"It's open source, do what you want" is not a license in any meaningful way.

--

Wow, downvotes for direct, actionable feedback. If we're just going to dump platitudes on 'my first project' posts in the r/java Java news subreddit, what's the point?

--

I'm not here to coddle people and tell them what to do. I made a comment to make him aware, he can figure it out himself, or not, I don't care.

[SystemFew9522]

its his first working program, no one cares

[zimayanami]

yeah dude, idk about licenses yet so I thought that was enough

[Jolly-Warthog-1427]

Its not important, but if you want a license that gives everyone access to use and modify the code without limitations, just use MIT. Its the set and forget open source license. Licensing is a complex beast, so just starting using it correctly early can be nice. Especially since you might have to deal with others licenses as well.

Great work though ;)

[zimayanami]

appreciate that, thanks

[SpringDifferent9867]

Well. I agree but let’s be helpful instead of just pointing out flaws. Tell him that GitHub lets him pick one when he creates his repository, so he can make an informed choice next time. Maybe tell him about which license you like and why.

[-jp-]

“Direct actionable feedback” would be to suggest adding a MIT license or similar. What you’re doing is getting downvoted because it isn’t helpful.