updated refresh ribbon

Author: udaykirang

powerapps-docs/developer/model-driven-apps/clientapi/reference/formContext-ui/refreshRibbon.md

@@ -32,12 +32,16 @@ search.app:
 
 ## Remarks
 
- This function is typically used when a ribbon `<EnableRule>` (RibbonDiffXml) depends on a value in the form. After your code changes a value that is used by a rule, use this method to force the ribbon to re-evaluate the data in the form so that the rule can be applied.
+This function is used when a ribbon action `JavaScriptFunction` (RibbonDiffXml) changes the data in the form. For example, changing of state of the record via a ribbon action. After your code changes the data that is used by a rule, use this method to force the ribbon to reevaluate the data in the form so that the rule can be reapplied.
 
-### Related topics
+## Guidance
+
+For optimal performance of your form loads, you should not use this function in `EnableRule` (RibbonDiffXml) or `onLoad` (FormXml). The form load itself triggers rules violation of all the ribbon actions and you should use promises and asynchronous pattern in `EnableRule` to control the visibility of a ribbon action.
 
-[formContext.ui](../formContext-ui.md)
 
+### Related topics
+
+[formContext.ui](../formContext-ui.md)      
 [formContext](../../clientapi-form-context.md)
 
 

powerapps-docs/maker/data-platform/use-powerapps-checker.md

@@ -165,6 +165,7 @@ Here's a summary of each column in the report.
 | Web Resources  | [web-avoid-eval](https://go.microsoft.com/fwlink/?LinkID=398563&error=web-avoid-eval&client=PAChecker)  | Don't use the 'eval' function or its functional equivalents.  | 
 | Web Resources  | [web-remove-alert](https://go.microsoft.com/fwlink/?LinkID=398563&error=web-remove-alert&client=PAChecker)  | Don't use the 'alert' function or its functional equivalents.  | 
 | Web Resources  | [web-remove-console](https://go.microsoft.com/fwlink/?LinkID=398563&error=web-remove-console&client=PAChecker)  | Avoid using methods on console.  | 
+| Web Resources  | [web-avoid-ui-refreshribbon](https://go.microsoft.com/fwlink/?linkid=2157641&error=web-remove-console&client=PAChecker)  | Avoid using refreshRibbon in form onload and EnableRule. | 
 | Canvas App  | [app-formula-issues-high](https://go.microsoft.com/fwlink/?LinkID=398563&error=app-formula-issues-high&client=PAChecker)  | Refer to Power Apps formula references for additional details.  | 
 | Canvas App  | [app-formula-issues-medium](https://go.microsoft.com/fwlink/?LinkID=398563&error=app-formula-issues-medium&client=PAChecker)  | Refer to Power Apps formula references for additional details.  | 
 | Canvas App  | [app-formula-issues-low](https://go.microsoft.com/fwlink/?LinkID=398563&error=app-formula-issues-low&client=PAChecker)  | Refer to Power Apps formula references for additional details. |