kozec / dumbxinputemu

xinput reimplementation compatibile with DirectInput controllers
GNU Lesser General Public License v3.0
133 stars 12 forks source link

Improve installation documentation #27

Open Swizzler121 opened 2 years ago

Swizzler121 commented 2 years ago

I provide the occasional assistance with Linux newbies on help forums. One brought this project to my attention when they were attempting to get one of their games working with their controller.

Your install documentation is a bit lacking, especially for new linux users:

Does it matter where you extract it to? does it only temporarily use that folder, or will it live in that folder from then on? Possibly suggest a default location

Bonus points for explaining how to extract a .tar.gz file for newbies who have never encountered them before

I don't use winetricks much, so even this is greek to me. Once again, does this require that the directory I extracted the files to need to stay the same before I run this setup? If so providing a default extract location would be helpful, as without it I might extract it to a temporary folder or the downloads folder.

bonus points for explaining you need to navigate to the directory you extracted the files to and run the command. Also might specify if the command needs to be run as sudo, or if running the command as sudo will cause problems (I know when I first started out on linux I ran a bunch of stuff on sudo I shouldn't have and broke things as a result)

If a user does this, do the rest of the files still need to exist where they were extracted? answering the first question helps answer this one.

Don't have too much issue with this line, as it's just providing additional information.

When I downloaded the release archive, I immediately came upon an question I wasn't sure the answer to. Included in the archive are a 32 and 64 folder, I'm assuming referring to 32 bit and 64 bit. A normal pc user trying Linux for the very first time, might not know this, so explaining what these folders mean might help. Also, I'm not sure if it's referring to if the game is 32 or 64 bit, or if my Linux environment is 32 or 64 bit.

If it is referring to if my game is 32 or 64 bit, a guide on how to determine this, or even that a user needs to determine this before using your project, would be very helpful.

Not trying to be mean or hurtful, just trying to provide meaningful feedback on your install guide after finding out new users were struggling to understand it, but wanting to use your project!

FrankReynoldsIII commented 1 year ago

I have no idea what environment variables are or how to use them. I have a JS controller and I can't use it and I have no clue how to change it.