Unify code comments across special page stylesheets

Change-Id: I6311b441552bfd05f737f106b534f213797d426a

diff --git a/resources/src/mediawiki.special/apisandbox.css b/resources/src/mediawiki.special/apisandbox.css
index 4dc4c27..923b595 100644 (file)
--- a/resources/src/mediawiki.special/apisandbox.css
+++ b/resources/src/mediawiki.special/apisandbox.css
@@ -1,3 +1,6 @@
+/*!
+ * Styles for Special:ApiSandbox
+ */
 .client-js .mw-apisandbox-nojs {
        display: none;
 }

diff --git a/resources/src/mediawiki.special/block.less b/resources/src/mediawiki.special/block.less
index d7ee3da..6d12722 100644 (file)
--- a/resources/src/mediawiki.special/block.less
+++ b/resources/src/mediawiki.special/block.less
@@ -1,10 +1,12 @@
-/* Special:Block styles */
+/*!
+ * Styles for Special:Block
+ */
 
-// OOUIHTMLForm styles
-@ooui-font-size-browser: 16; // Assumed browser default of `16px`
-@ooui-font-size-base: 0.875em; // Equals `14px` at browser default of `16px`
+// OOUIHTMLForm specifics
+@ooui-font-size-browser: 16; // Assumed browser default of `16px`.
+@ooui-font-size-base: 0.875em; // Equals `14px` at browser default of `16px`.
 
-@ooui-spacing-radio-label: 26 / @ooui-font-size-browser / @ooui-font-size-base; // Equals `1.85714286em`≈`26px`
+@ooui-spacing-radio-label: 26 / @ooui-font-size-browser / @ooui-font-size-base; // Equals `1.85714286em`≈`26px`.
 
 body.mw-special-Block {
        .mw-block-editing-restriction.oo-ui-fieldLayout {

diff --git a/resources/src/mediawiki.special/comparepages.less b/resources/src/mediawiki.special/comparepages.less
index 87b7a8b..38b4078 100644 (file)
--- a/resources/src/mediawiki.special/comparepages.less
+++ b/resources/src/mediawiki.special/comparepages.less
@@ -1,3 +1,6 @@
+/*!
+ * Styles for Special:ComparePages
+ */
 @import 'mediawiki.mixins';
 
 .mw-special-ComparePages .mw-htmlform-ooui-wrapper {

diff --git a/resources/src/mediawiki.special/edittags.css b/resources/src/mediawiki.special/edittags.css
index 204009c..8964a13 100644 (file)
--- a/resources/src/mediawiki.special/edittags.css
+++ b/resources/src/mediawiki.special/edittags.css
@@ -1,5 +1,5 @@
 /*!
- * Styling for Special:EditTags and action=editchangetags
+ * Styles for Special:EditTags and action=editchangetags
  */
 #mw-edittags-tags-selector td {
        vertical-align: top;

diff --git a/resources/src/mediawiki.special/newpages.less b/resources/src/mediawiki.special/newpages.less
index 835cab8..8d72b11 100644 (file)
--- a/resources/src/mediawiki.special/newpages.less
+++ b/resources/src/mediawiki.special/newpages.less
@@ -1,5 +1,5 @@
 /*!
- * Styling for Special:NewPages
+ * Styles for Special:NewPages
  */
 
 // OOUIHTMLForm styles

diff --git a/resources/src/mediawiki.special/pagesWithProp.css b/resources/src/mediawiki.special/pagesWithProp.css
index 7ef75d0..7240bd4 100644 (file)
--- a/resources/src/mediawiki.special/pagesWithProp.css
+++ b/resources/src/mediawiki.special/pagesWithProp.css
@@ -1,4 +1,8 @@
-/* Distinguish actual data from information about it being hidden visually */
+/*!
+ * Styles for Special:PagesWithProp
+ */
+
+/* Distinguish actual data from information about it being hidden visually. */
 .prop-value-hidden {
        font-style: italic;
 }

diff --git a/resources/src/mediawiki.special/special.less b/resources/src/mediawiki.special/special.less
index 35071be..3798f1e 100644 (file)
--- a/resources/src/mediawiki.special/special.less
+++ b/resources/src/mediawiki.special/special.less
@@ -1,6 +1,9 @@
-/* Special:AllMessages */
+/*!
+ * Styles shared across various special pages.
+ */
 @import 'mediawiki.mixins';
 
+/* Special:AllMessages */
 /* Visually hide repeating text, but leave in for better form navigation on screen readers */
 .mw-special-Allmessages .mw-htmlform-ooui .oo-ui-fieldsetLayout:first-child .oo-ui-fieldsetLayout-header {
        .mixin-screen-reader-text();

diff --git a/resources/src/mediawiki.special/upload.css b/resources/src/mediawiki.special/upload.css
index 626a7e8..0a5796e 100644 (file)
--- a/resources/src/mediawiki.special/upload.css
+++ b/resources/src/mediawiki.special/upload.css
@@ -1,5 +1,5 @@
 /*!
- * Styling for Special:Upload
+ * Styles for Special:Upload
  */
 .mw-destfile-warning {
        border: 1px solid #fde29b;

diff --git a/resources/src/mediawiki.special/userrights.css b/resources/src/mediawiki.special/userrights.css
index 14ad695..06a74f5 100644 (file)
--- a/resources/src/mediawiki.special/userrights.css
+++ b/resources/src/mediawiki.special/userrights.css
@@ -1,5 +1,5 @@
 /*!
- * Styling for Special:UserRights
+ * Styles for Special:UserRights
  */
 .mw-userrights-nested {
        margin-left: 1.2em;

diff --git a/resources/src/mediawiki.special/watchlist.css b/resources/src/mediawiki.special/watchlist.css
index c9861c2..1660bd2 100644 (file)
--- a/resources/src/mediawiki.special/watchlist.css
+++ b/resources/src/mediawiki.special/watchlist.css
@@ -1,5 +1,5 @@
 /*!
- * Styling for elements generated by JavaScript on Special:Watchlist
+ * Styles for elements generated by JavaScript on Special:Watchlist
  */
 .mw-changelist-line-inner-unwatched {
        text-decoration: line-through;