libgdx / libgdx.github.io

Github hosted site for libGDX
62 stars 195 forks source link

THIS WIKI IS BOOTY, READ MY SUGGESTION. #200

Closed ff0044 closed 1 month ago

ff0044 commented 1 month ago

Issue details

Hi there. Your wiki has been moved from github wiki to its own page. That is a good step however I cannot seem to find any sort of tutorial or documentation without it being outdated by 10 years, it being an asteroid shooter game (we dont need a million more of those) and not much documentation on the wiki.

I have tried to look on how to do collisions using Tiled. I have also looked up a good platformer tutorial for a beginner, considering I have never used the platform. Instead, I have resorted to using AI instead of spending time writing down the code and tweaking it to however I like. Instead, I am left with a dumpsterfire of code that works with a 50/50 chance.

LibGDX is really great, but there is not enough documentation on how to fix up steps and the tutorials are outdated.

What would liked to happen

What would be best to happen is to update the wiki. The wiki is the first ever place for someone to check out the project, but with such little documentation, you cannot even manage to retain the quality of the code outputted. It would be best if the wiki gets updated and with a starter tutorial being more than a measly water bucket and droplets. A suggestion is for a platformer to be made. Creating a platformer as the first thing a player makes is great because it means the background music, the sound effects, the Tiled Map (great to go for RPG), the enemy AI, the physics (using Box2D or others), the background, menu, etc. I could go on for more talking about how beneficial a platformer tutorial would be.

Anyways, here is my rant. If you read up to here, I appreciate it and hope you can help towards the cause. Tyia. -T

Frosty-J commented 1 month ago

Hello, https://github.com/libgdx/libgdx.github.io/issues is the place to complain about the wiki. And yeah, the starter tutorial sucks - it doesn't even use viewports!

You may find the following resources useful for the things you have mentioned:

Combining everything involved for a complete platformer into one tutorial may be out of scope for the wiki.

crykn commented 1 month ago

Hey @TitaKalium, thanks for your comment! We are aware that the wiki is in need of improvements, and are currently in the process of tackling a couple of its issues. But we are few and time is spare, so if anyone is interested in helping out, PRs and specific suggestions are very welcome – both here and on Discord!