When there are known issues with a particular feature, the description of the issue should be linked or embedded in that feature's help file. Understanding the limits or bugs in certain features would save users a lot of time.
For example, in the Manage Map Server Cache Tiles tool help file
, it would be helpful to have the issue "When using the Manage Map Server Cache Tiles tool in ArcMap, the results do not retain the defined area of interest (AOI)" annotated in this help file. If a fix is planned, it would be helpful to know the version for the fix (eg. 10.2.1).