It seems like a bug report on what is not clear in the documentation would be highly useful.