document readthedocs workaround for changed state

[RonnyPfannschmidt]

trafficstars

thanks for the update - hat one is a neat workaround - we should probably put it to the docs

Originally posted by @RonnyPfannschmidt in #962