Update documentation for changes in recompilation logic
With !5661 (merged) getting merged the recompilation story changed quite a bit, so the documentation needs to be updated to reflect this.
With !5661 (merged) getting merged the recompilation story changed quite a bit, so the documentation needs to be updated to reflect this.