html5/spec-author-view style.css,1.4,1.5

Update of /sources/public/html5/spec-author-view
In directory hutz:/tmp/cvs-serv8061

Modified Files:
	style.css 
Log Message:
add some notes about my rudimentary styling attempts: hopefully these might prove useful to the real designers after we trick them into taking over the styling tasks on this...


Index: style.css
===================================================================
RCS file: /sources/public/html5/spec-author-view/style.css,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- style.css	8 Jul 2010 13:36:04 -0000	1.4
+++ style.css	9 Jul 2010 04:23:25 -0000	1.5
@@ -1,3 +1,8 @@
+/* the @class=full-spec links are "external" links to the full
+ * HTML5 spec (not internal ones to others parts in the author
+ * view); so we want some kind of visual warning indication to
+ * users that if they follow them, they will be leaving the author
+ * view and finding themselves in the full spec instead */
 a.full-spec-link:link:hover,
 a.full-spec-:visited:hover
 {
@@ -6,10 +11,20 @@
   outline-offset: 4px;
   outline: solid green;
 }
+/* this is for the first paragraph that we add to the Abstract;
+ * that paragraph is specific to the author view (it's not in the
+ * full spec); its purpose is to alert readers to the fact that
+ * this is a subset of the full spec */
 .strong-note {
   outline-offset: 4px;
   outline: solid green;
 }
+/* intent of this is to give a clear reminder on each page that
+ * this is not the full spec; but if we instead change the overall
+ * formatting of the document to tune it for an author audience,
+ * that will very clearly set it apart visually from the full spec
+ * proper, and there will be no risk of anybody mistaking the two,
+ * and we could remove this generated text */
 h3:after, h4:after, h5:after {
   content: "  (details for Web Authors)";
   color: #bbb;
@@ -18,7 +33,6 @@
 .toc + h3:after {
   content: "";
 }
-
 h1 .rcsrevision {
   color: #bbb;
 }

Received on Friday, 9 July 2010 04:23:28 UTC