We actually use method comments for user documentation as well. Only on specific business methods, but it’s nice to have a good comment for the dev and a tooltip for the user at the same time.

Sorry, but that is far from correct. Of course you can throttle wind and solar production if you want, but the problem of to much energy is a nice to have. You could create Hydrogen or desalinate water in large scales if you got energy left over Regarding nuclear power: If you calculate the cost of nuclear and include that you need to store the waste for thousands of years it’s not cheap either. And you also need to source the fuel from somewhere. Uranium is not abundant. And also it takes 20 years to build an new plant. By then it will be even lest cost effective. Rather continue with wind and solar and then batteries for the money.