mw.ui: button: Update usage instructions for neutral and quiet buttons

Bug: T75252
Change-Id: If18d4773f491d465309662a7decd8466673002fe

diff --git a/resources/src/mediawiki.ui/components/buttons.less b/resources/src/mediawiki.ui/components/buttons.less
index 6ba7bf7..f88f3ee 100644 (file)
--- a/resources/src/mediawiki.ui/components/buttons.less
+++ b/resources/src/mediawiki.ui/components/buttons.less
@@ -17,6 +17,8 @@
 
 // Neutral button styling
 //
+// These are the main actions on the page/workflow. The page should have only one of progressive, constructive and desctructive buttons, the rest being quiet.
+//
 // Markup:
 // <div>
 //   <button class="mw-ui-button">.mw-ui-button</button>
@@ -187,8 +189,8 @@
 
        // Quiet buttons
        //
-       // Use quiet buttons when they are less important and alongside other constructive/progressive/destructive buttons.
-       // Use of quiet buttons is not recommended on mobile/tablet due to lack of hover state.
+       // Use quiet buttons when they are less important and alongside other constructive, progressive or destructive buttons. It should be used for an action that exits the user from the current view/workflow.
+       // Its use is  not recommended on mobile/tablet due to lack of hover state.
        //
        // Markup:
        // <div>