add comments about the purpose of skins/common/common*.css files

Per Dantman's (Daniel Friesen) comments on
https://www.mediawiki.org/wiki/Special:Code/MediaWiki/95837.

Also a little cleanup in the header comments.

Change-Id: I8bc5d591ade631b9bb030e8ab6e102fd3146247a

diff --git a/skins/common/commonContent.css b/skins/common/commonContent.css
index 0fe8489..20182b4 100644 (file)
--- a/skins/common/commonContent.css
+++ b/skins/common/commonContent.css
@@ -1,6 +1,9 @@
-/*
-** MediaWiki style sheet for general styles on complex content
-*/
+/**
+ * MediaWiki style sheet for general styles on complex content
+ *
+ * Styles for complex things which are a standard part of page content
+ * (ie: the CSS classing built into the system), like the TOC.
+ */
 
 /* Table of Contents */
 #toc,

diff --git a/skins/common/commonElements.css b/skins/common/commonElements.css
index 02fd29f..79911fe 100644 (file)
--- a/skins/common/commonElements.css
+++ b/skins/common/commonElements.css
@@ -1,6 +1,9 @@
 /**
  * MediaWiki style sheet for general styles on basic content elements
- * This style sheet is used by the monobook and vector skins
+ *
+ * Styles for basic elements: links, lists, etc...
+ *
+ * This style sheet is used by the Monobook and Vector skins.
  */
 
 /* Links */

diff --git a/skins/common/commonInterface.css b/skins/common/commonInterface.css
index 60d6436..af6665e 100644 (file)
--- a/skins/common/commonInterface.css
+++ b/skins/common/commonInterface.css
@@ -1,6 +1,10 @@
-/*
-** MediaWiki style sheet for common core styles on interfaces
-*/
+/**
+ * MediaWiki style sheet for common core styles on interfaces
+ *
+ * Styles for the Monobook/Vector pattern of laying out common interfaces.
+ * These ids/classes are not built into the system,
+ * they are outputted by the actual MonoBook/Vector code by convention.
+ */
 
 /* Categories */
 .catlinks {