From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <tews@os.inf.tu-dresden.de>
X-Original-To: caml-list@yquem.inria.fr
Delivered-To: caml-list@yquem.inria.fr
Received: from mail1-relais-roc.national.inria.fr (mail1-relais-roc.national.inria.fr [192.134.164.82])
	by yquem.inria.fr (Postfix) with ESMTP id D8BC1BC58
	for <caml-list@yquem.inria.fr>; Tue, 14 Sep 2010 11:55:27 +0200 (CEST)
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: Aj8EAMvjjkyNTDBjgWdsb2JhbAChThUBARYiIsJ2hUAEhH+FKA
X-IronPort-AV: E=Sophos;i="4.56,363,1280700000"; 
   d="scan'208";a="67550838"
Received: from os.inf.tu-dresden.de ([141.76.48.99])
  by mail1-smtp-roc.national.inria.fr with ESMTP/TLS/DHE-RSA-AES256-SHA; 14 Sep 2010 11:55:27 +0200
Received: from [2002:8d4c:3001:48:222:68ff:fe19:71d] (helo=blau.inf.tu-dresden.de)
	by os.inf.tu-dresden.de with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.72)
	id 1OvSEY-0000iP-93; Tue, 14 Sep 2010 11:55:26 +0200
Received: from tews by blau.inf.tu-dresden.de with local (Exim 4.72)
	(envelope-from <tews@blau.inf.tu-dresden.de>)
	id 1OvSEW-00014T-Ue; Tue, 14 Sep 2010 11:55:25 +0200
From: Hendrik Tews <tews@os.inf.tu-dresden.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Message-ID: <19599.18060.461332.705041@blau.inf.tu-dresden.de>
Date: Tue, 14 Sep 2010 11:55:24 +0200
To: bluestorm <bluestorm.dylc@gmail.com>
Cc: caml-list@inria.fr
Subject: Re: [Caml-list] Enhanced Ocaml Documentation 3.12
In-Reply-To: <AANLkTimC9=ax6T3Y3Lbj-hBMnmYCz7xaKLO6MeMP0N7S@mail.gmail.com>
References: <19594.14241.815553.755280@blau.inf.tu-dresden.de>
	<AANLkTimC9=ax6T3Y3Lbj-hBMnmYCz7xaKLO6MeMP0N7S@mail.gmail.com>
X-Mailer: VM 8.1.0 under 23.2.1 (i486-pc-linux-gnu)
X-Spam: no; 0.00; hendrik:01 tews:01 tews:01 ocaml:01 ocaml:01 overkill:01 overkill:01 hendrik:01 enhances:98 border-style:98 border-width:98 tu-dresden:01 caml-list:01 caml-list:01 writes:01 

bluestorm writes:
   Date: Fri, 10 Sep 2010 16:04:36 +0200
   Subject: Re: [Caml-list] Enhanced Ocaml Documentation 3.12
   
   Very interesting ! Could you provide more information on the technical
   side : did you edit the manual by hand, or use an automatic diffing
   process ?
   
I diff the txt versions of the reference manual and change the
html version by hand. For the grammar rule index I use a tool and
manual editing.

   > This version of the Ocaml manual enhances the original html
   > version in the following way:
   >
   > - Changes (wrt version 3.10) are tagged with icons and color
   
   I find the "yellow background" style a bit hard on the eye for large
   changes. While it's useful for small changes (words or sentences),
   it's overkill and incomfortable for large paragraphs.

Yes, these yellow sections are an overkill. However, everybody
knows that 7.10-7.17 are new. So I only marked them for
consistency. Most people know about these changes already and
won't read them again in the enhanced manual.


   I would be happy to propose a better visual style, however this is
   made quite difficult by your use of non-semantic markup such as:
   
     <div style="background-color:yellow; color:red; border-style:none;
   border-width:0.5pt">
   
   Could you use CSS instead ? 

I'll keep this in mind for 3.13. If you have suggestions for
better color combinations I am very interested. However, I will
not change version 3.12 again, I already spent too much time on
it. 


Bye,

Hendrik