docs: update README.md

1 files changed, 39 insertions, 36 deletions

diff --git a/README.md b/README.md
index a0e075c..6bad92b 100644
--- a/README.md
+++ b/README.md
@@ -1,32 +1,30 @@
 # Linux kernel module for Thrustmaster T300RS, T248 and TX(experimental) wheels
+> **DISCLAIMER:** The module is now ready for near-stable USE in most force feedback games, supports rangesetting as well as gain and autocentering along with most force feedback effects. While I haven't personally come across any crashes or lockups with this version, I can't promise that they won't occur under any circumstances.
 
-## Description
-A Linux kernel module for Thrustmaster T300RS, T248, and TX wheels is a software component designed to enhance the compatibility and functionality of these popular racing wheel peripherals when used with Linux-based operating systems. This kernel module allows seamless integration of Thrustmaster wheels with the Linux kernel, providing users with a robust and feature-rich experience for gaming and other applications.
-
-I've made some improvements to the dynamic updating of effects, and while still far for perfect, the experience is slowly getting better and better. Some drawbacks include possible effect inaccuracies in comparison with the Windows driver and in some games inconsistent pedal mapping. Meaning that all pedals should be detected in games, but may be mapped incorrectly.
+![GitHub last commit (branch)](https://img.shields.io/github/last-commit/Kimplul/hid-tmff2/master)
+![GitHub](https://img.shields.io/github/license/Kimplul/hid-tmff2)
+![GitHub contributors](https://img.shields.io/github/contributors/Kimplul/hid-tmff2)
 
-> **Current version ``0.8`` is USABLE in most force feedback games, supports rangesetting as well as gain and autocentering along with most force feedback effects.** While I haven't personally come across any crashes or lockups with this version, I can't promise that they won't occur under any circumstances.
 
-### Help wanted with adding more Thrustmaster wheels
-Currently open requests for wheels:
-+ [T500 RS](https://github.com/Kimplul/hid-tmff2/issues/18)
-+ [T818](https://github.com/Kimplul/hid-tmff2/issues/58)
-+ [T-GT II](https://github.com/Kimplul/hid-tmff2/issues/55)
+## Description
+A Linux kernel module for Thrustmaster T300RS, T248, and TX (experimental support) wheels is a software component designed to enhance the compatibility and functionality of these popular racing wheel peripherals when used with Linux-based operating systems. This kernel module allows seamless integration of Thrustmaster wheels with the Linux kernel, providing users with a robust and feature-rich experience for gaming and other applications with working force feedback effects.
 
-If you would like to help add a wheel to this driver, please have a look through the [wiki](https://github.com/Kimplul/hid-tmff2/wiki#how-to-add-in-support-for-a-new-t-series-wheel) and/or [CONTRIBUTING.md](./docs/CONTRIBUTING.md) for what might need to be done. If you have a wheel that's not on the list, but suspect it might fit into the driver, please feel free to open up an issue about it.
+I've been working on enhancing the real-time updating of effects, and although it's not flawless yet, the overall experience is gradually improving. There are a couple of issues, though. First, there might be occasional inaccuracies in how the effects compare to the Windows driver. Second, in certain games, the mapping of pedal inputs can be inconsistent. This means that while all pedals should be recognized by the games, they might not be mapped correctly.
 
 ## Installation
-### Dependencies
-Kernel modules require kernel headers to be installed.
-
-+ Debian-based: ``sudo apt install linux-headers-$(uname -r)``
-+ Arch-based: ``sudo pacman -S linux-headers``
-+ Fedora-based: ``sudo yum install kernel-devel kernel-headers``
+You can either install this kernel module by using DKMS or manually building from source:
 
-> **NOTE:** See [here](https://github.com/Kimplul/hid-tmff2/wiki/Integrating-driver-into-distros) for install instructions for other linux distributions.
+### Dependencies
+Kernel modules require kernel headers to be installed. Use any one of the right command for your distribution:
+```shell
+$ sudo apt install linux-headers-$(uname -r) #Debian-based 
+$ sudo pacman -S linux-headers #Arch-based 
+$ sudo yum install kernel-devel kernel-headers #Fedora-based 
+```
 
-### Manual installation
+#### Manual installation
 + Unplug wheel from computer
++ Use the following commands in your terminal of choice:
 ```shell
 git clone --recurse-submodules https://github.com/Kimplul/hid-tmff2.git
 cd hid-tmff2/src
@@ -34,34 +32,39 @@ make
 sudo make install
 ```
 + Plug wheel back in
-+ Reboot (not strictly necessary, but definitely recommended)
-    
-Done!
-
-> **NOTE:** On some systems, you will get an error/warning about SSL. This is normal for unsigned modules. For info on signing modules yourself (completely optional), see [here](https://www.kernel.org/doc/html/latest/admin-guide/module-signing.html?highlight=module%20signing).
-
-> **NOTE:** Thrustmaster TX wheels aren't supported by `hid-tminit` as of yet, meaning that TX wheels have to be initialized with `tmrd`. Please see https://github.com/Kimplul/hid-tmff2/issues/48.
++ Reboot *(Optional, yet Recommended)*
 
-### DKMS
+#### DKMS (Dynamic Kernel Module Support)
 + Unplug wheel from computer
-```shell
-sudo bash ./dkms/dkms-install.sh
-```
++ Clone the repo `git clone --recurse-submodules https://github.com/Kimplul/hid-tmff2.git`
++ Use `sudo bash hid-tmff2/dkms/dkms-install.sh` on your terminal of choice
 + Plug wheel back in
-+ reboot (not strictly necessary, but definitely recommended)
++ Reboot *(Optional, yet Recommended)*
+
+> **NOTE:** See [here](https://github.com/Kimplul/hid-tmff2/wiki/Integrating-driver-into-distros) for install instructions for other linux distributions.
+
+> **NOTE:** On some systems, you will get an error/warning about SSL. This is normal for unsigned modules. For info on signing modules yourself (completely optional), see [here](https://www.kernel.org/doc/html/latest/admin-guide/module-signing.html?highlight=module%20signing).
 
-Done!
+> **NOTE:** Thrustmaster TX wheels aren't supported by `hid-tminit` as of yet, meaning that TX wheels have to be initialized with `tmrd`. Please see https://github.com/Kimplul/hid-tmff2/issues/48.
 
-> :warning: Warning: There have been reports that this driver does not work if the wheel's firmware version is older than v. 31.
+> :warning: **NOTE:** There have been reports that this driver does not work if the wheel's firmware version is older than v. 31.
 > To update the firmware, you will have to fire up a Windows installation and update the firmware using the official Thrustmaster tools.
 
-> :warning: Warning: There was a name change when adding support for the T248 from `hid-tmt300rs` to `hid-tmff-new`,
+> :warning: **NOTE:** There was a name change when adding support for the T248 from `hid-tmt300rs` to `hid-tmff-new`,
 > and you may have to uninstall the older version of the driver.
 
-## Additional tidbits
+## Contribute to project
+This project wants help from people who can contribute. If you would like to help add a wheel to this driver, please have a look through the [wiki](https://github.com/Kimplul/hid-tmff2/wiki#how-to-add-in-support-for-a-new-t-series-wheel) and/or [CONTRIBUTING.md](./docs/CONTRIBUTING.md) for what might need to be done. If you have a wheel that's not on the list, but suspect it might fit into the driver, please feel free to open up an issue about it.
+Currently open requests for wheels:
+- [T500 RS](https://github.com/Kimplul/hid-tmff2/issues/18)
+- [T818](https://github.com/Kimplul/hid-tmff2/issues/58)
+- [T-GT II](https://github.com/Kimplul/hid-tmff2/issues/55)
+- [T128P](https://github.com/Kimplul/hid-tmff2/issues/67)
+
+## FAQ (Frequently Asked Questions)
 + Reportedly some games running under Wine/Proton won't recognize wheels without the official Thrustmaster drivers installed within the prefix. See [#46](https://github.com/Kimplul/hid-tmff2/issues/46#issuecomment-1199080845). For installation instructions, see [wiki](https://github.com/Kimplul/hid-tmff2/wiki). Note that you will still need the Linux driver, the Windows driver just installs some files needed by games to correctly recognize the Linux driver. The Windows driver itself does not work under Wine/Proton.
 
-+ Until the updated `hid-tminit` is upstreamed, you might want to blacklist the kernel module `hid-thrustmaster`. Do this with
++ Until the updated `hid-tminit` is [upstreamed](https://github.com/scarburato/hid-tminit), you might want to blacklist the kernel module `hid-thrustmaster`. Do this with
     ```shell
     echo 'blacklist hid_thrustmaster' > /etc/modprobe.d/hid_thrustmaster.con
     ```