From: MatmaRex <matma.rex@gmail.com>
Date: Sat, 20 Oct 2012 17:52:41 +0000 (+0200)
Subject: add comments about the purpose of skins/common/common*.css files
X-Git-Tag: 1.31.0-rc.0~21928
X-Git-Url: https://git.cyclocoop.org/%7B%24www_url%7Dadmin/compta/banques/ajouter.php?a=commitdiff_plain;h=0953a6d618108fe93d9bc0784c3592211be1862d;p=lhc%2Fweb%2Fwiklou.git

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 0fe8489e6e..20182b4052 100644
--- 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 02fd29fe20..79911feda2 100644
--- 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 60d6436b9f..af6665e4b2 100644
--- 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 {