I've just watched my third tutorial in the FreeCAD Academy series. It constructs a simple part with a hole in it. The tutorial is in two parts. First it creates the part the way the official documentation says to do it. Then it shows that if you do this and subsequently make any changes the (worm)hole reappears on a different side from where it was before. So the second part of the tutorial says, no don't do what the documentation says. Do it this way (which is more complicated but works).
At least the tutorial is honest. It's describing the product, warts and all.