W3C home > Mailing lists > Public > public-dap-commits@w3.org > August 2012

2009/dap/ReSpec.js/bibref biblio.js,1.334,1.335

From: Robin Berjon via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 07 Aug 2012 14:19:45 +0000
To: public-dap-commits@w3.org
Message-Id: <E1SykdN-000369-TJ@lionel-hutz.w3.org>
Update of /sources/public/2009/dap/ReSpec.js/bibref
In directory hutz:/tmp/cvs-serv11823/ReSpec.js/bibref

Modified Files:
	biblio.js 
Log Message:
scaring people away from v3

Index: biblio.js
===================================================================
RCS file: /sources/public/2009/dap/ReSpec.js/bibref/biblio.js,v
retrieving revision 1.334
retrieving revision 1.335
diff -u -d -r1.334 -r1.335
--- biblio.js	6 Aug 2012 21:27:40 -0000	1.334
+++ biblio.js	7 Aug 2012 14:19:43 -0000	1.335
@@ -1,3 +1,86 @@
+
+/*
+I8,        8        ,8I           db           88888888ba     888b      88    88    888b      88      ,ad8888ba,     88  
+`8b       d8b       d8'          d88b          88      "8b    8888b     88    88    8888b     88     d8"'    `"8b    88  
+ "8,     ,8"8,     ,8"          d8'`8b         88      ,8P    88 `8b    88    88    88 `8b    88    d8'              88  
+  Y8     8P Y8     8P          d8'  `8b        88aaaaaa8P'    88  `8b   88    88    88  `8b   88    88               88  
+  `8b   d8' `8b   d8'         d8YaaaaY8b       88""""88'      88   `8b  88    88    88   `8b  88    88      88888    88  
+   `8a a8'   `8a a8'         d8""""""""8b      88    `8b      88    `8b 88    88    88    `8b 88    Y8,        88    ""  
+    `8a8'     `8a8'         d8'        `8b     88     `8b     88     `8888    88    88     `8888     Y8a.    .a88    aa  
+     `8'       `8'         d8'          `8b    88      `8b    88      `888    88    88      `888      `"Y88888P"     88  
+
+
+
+
+
+
+
+
+
+                                                                                                        
+88888888ba,             db           888b      88      ,ad8888ba,     88888888888    88888888ba     88  
+88      `"8b           d88b          8888b     88     d8"'    `"8b    88             88      "8b    88  
+88        `8b         d8'`8b         88 `8b    88    d8'              88             88      ,8P    88  
+88         88        d8'  `8b        88  `8b   88    88               88aaaaa        88aaaaaa8P'    88  
+88         88       d8YaaaaY8b       88   `8b  88    88      88888    88"""""        88""""88'      88  
+88         8P      d8""""""""8b      88    `8b 88    Y8,        88    88             88    `8b      ""  
+88      .a8P      d8'        `8b     88     `8888     Y8a.    .a88    88             88     `8b     aa  
+88888888Y"'      d8'          `8b    88      `888      `"Y88888P"     88888888888    88      `8b    88  
+
+
+
+
+
+    Got your attention? Good. Please read the following carefully.
+    
+    You are currently editing the bibliographical database for ReSpec version 1.
+    
+    The version of ReSpec, as of this writing, is 3.1. That should raise a red flag.
+    
+    The code behind ReSpec v1 is no longer supported. It is still in this repository, and
+    the plan is that it will stay there. You can use it, and you can patch it. But it 
+    isn't officially supported, so you have to understand that you're essentially on your 
+    own.
+    
+    For the time being, at regular intervals I take the edits that people make in this 
+    file, and push them to the new version (note that I don't do the reverse though, so
+    you're not getting the collectively-gathered bibliographical updates that others 
+    are). As of TPAC 2012, I will stop doing even just that, and the v1 codeline will be
+    entirely extinct. You can keep on using it anyway, so long as you are aware of the 
+    consquences.
+    
+    Why would you switch to v3? Well, unless you've been doing something really naughty,
+    it's completely backwards compatible. It's 5x smaller (and that's going to improve 
+    even more soon) and makes 10x fewer HTTP requests to load. Dozens of bugs have been 
+    fixed since maintenance stopped on the v1 line, and a number of features have been 
+    added. People have spontaneously written in to say how much faster it is. The code is
+    modular, can easily be extended, and ReSpec can now be used to process other types of
+    technical documents just by rearranging the modules differently. It's test suite 
+    and new development cycle should also help ensure that it doesn't break live.
+    
+    Wow, that's increadibly sexy! How do I upgrade?
+    You replace:
+        <script src='http://dev.w3.org/2009/dap/ReSpec.js/js/respec.js' class='remove'></script>
+    with:
+        <script src='http://www.w3.org/Tools/respec/respec-w3c-common' class='remove' async></script>
+
+    And normally you should be done. If you see issues: robin@berjon.com.
+
+    I still want to contribute to the biblio DB, what do I do?
+    Until TPAC 2012, if you're still using v1 you can just edit here and at some point I 
+    will reflect the change in the v3 DB.
+    If you've switched to v3, you can edit the DB by forking the repository at
+    https://github.com/darobin/respec/ and making a pull request (that can entirely be
+    done online if you're in a hurry).
+    Managing the DB in this way is not wonderful, it is only kept around for now while
+    in the transition period (which is to say, until TPAC 2012). After that, there will
+    just be a Web-based system that will progressively become easier to use.
+
+
+    Brought to you with care and loving from Robin Berjon <robin@berjon.com>
+
+*/
+
 berjon.biblio = {
    "ABA-DSIG-GUIDELINES" : "<a href=\"http://www.signelec.com/content/download/digital_signature_guidelines.pdf\"><cite>Digital Signature Guidelines.</cite></a> 1 August 1996. Information Security Committee, American Bar Association. URL: <a href=\"http://www.signelec.com/content/download/digital_signature_guidelines.pdf\">http://www.signelec.com/content/download/digital_signature_guidelines.pdf</a>",
    "ABC" : "Leo Geurts; Lambert Meertens; Steven Pemberton. <a href=\"http://www.cwi.nl/~steven/abc\"><cite>The ABC Programmer's Handbook.</cite></a> Prentice-Hall. ISBN: 0-13-000027-2. URL: <a href=\"http://www.cwi.nl/~steven/abc\">http://www.cwi.nl/~steven/abc</a>",
Received on Tuesday, 7 August 2012 14:19:52 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 7 August 2012 14:19:52 GMT