Documentation help

[azlux]

Hi,
I'm setting thermostat at my house. I was using the simple HA thermostat and observe there are some improvements can be done during heating period.
And I found your project after digging a little bit. Maybe you can give a better name to this fork, (custom_components did not attract me when I was search for a project like this one. I was expecting something like "smart thermostat" or "better regulation thermostat".

I've read you project, but I've never heard of PID and PWM. I want to propose you to create a better Readme to help new people finding their way here.
I saw some answers parts only, but I still have many questions :

• PWD : https://community.home-assistant.io/t/thermostat-with-pid-controller/55834/83
  • time of your heater to reach 100% (time until the radiator feels very hot). if min_cycle_duration is larger then that take that time and multiply it by 3 for pwm.
• kp ki kd : value of gain influences system performance.
  • maybe you can give some starting value, what I understand is : if we use an autotune, the PID values will adapt. What's the best way to select the autotune ?
• difference : Not sure about this one.

I know python coding if you need help, and with the answer you will give me, I can make a PR to add them on the Readme.

Thank for your work.
Azlux