documentation cleanup inspired by 23597
Merge pull request #1465 from shackbarth/23597-inv-avail-lazy

documentation cleanup inspired by 23597