more documentation for workaround