Re: [TOOLS-DEVELOPMENT] CSS for RFCs SOW

"Joe Hildebrand (jhildebr)" <jhildebr@cisco.com> Sun, 17 July 2016 13:34 UTC

Return-Path: <jhildebr@cisco.com>
X-Original-To: tools-development@ietfa.amsl.com
Delivered-To: tools-development@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 04932128B44 for <tools-development@ietfa.amsl.com>; Sun, 17 Jul 2016 06:34:45 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -15.808
X-Spam-Level:
X-Spam-Status: No, score=-15.808 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-1.287, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id qi3kLH0hZMXD for <tools-development@ietfa.amsl.com>; Sun, 17 Jul 2016 06:34:43 -0700 (PDT)
Received: from alln-iport-2.cisco.com (alln-iport-2.cisco.com [173.37.142.89]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 532D412D16F for <tools-development@ietf.org>; Sun, 17 Jul 2016 06:34:43 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=2954; q=dns/txt; s=iport; t=1468762483; x=1469972083; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-id:content-transfer-encoding: mime-version; bh=LU9E1AIWez+aflNUmQ33N3UXo7zn6J5AaTaOwPQKyO4=; b=AW6WhV5TYZ5XZy+ooyAIw+O1eLJewyxQQXuPP3WcY6CIDeyo//3lqkv+ L1X8fFq0OIPaGgxQBpbTbgPW/Xi2UytFYWi1NoFmZ/zf9VmF1PKgMQEQW Cw7Ahw72gJbapsZimIIcVhsSg17MGACLVZYML+xHZI20LKUZNE2RdvxC4 g=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0BPAgDiiItX/4cNJK1bgz9WfAa4cIF5IoV4AoEgOBQBAQEBAQEBZSeEXAEBBAEBATg0CwULAgEIGB4QJwslAgQOBYgoCA6+LQEBAQEBAQEBAQEBAQEBAQEBAQEBARcFhiqBeIJVhECDLIIvBZNjhUEBhhKITIFrjUyGX4k+AR42g3Nuhxt/AQEB
X-IronPort-AV: E=Sophos;i="5.28,378,1464652800"; d="scan'208";a="297319892"
Received: from alln-core-2.cisco.com ([173.36.13.135]) by alln-iport-2.cisco.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 17 Jul 2016 13:34:42 +0000
Received: from XCH-RTP-001.cisco.com (xch-rtp-001.cisco.com [64.101.220.141]) by alln-core-2.cisco.com (8.14.5/8.14.5) with ESMTP id u6HDYg5e002670 (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=FAIL); Sun, 17 Jul 2016 13:34:42 GMT
Received: from xch-rtp-001.cisco.com (64.101.220.141) by XCH-RTP-001.cisco.com (64.101.220.141) with Microsoft SMTP Server (TLS) id 15.0.1210.3; Sun, 17 Jul 2016 09:34:40 -0400
Received: from xch-rtp-001.cisco.com ([64.101.220.141]) by XCH-RTP-001.cisco.com ([64.101.220.141]) with mapi id 15.00.1210.000; Sun, 17 Jul 2016 09:34:40 -0400
From: "Joe Hildebrand (jhildebr)" <jhildebr@cisco.com>
To: "Heather Flanagan (RFC Series Editor)" <rse@rfc-editor.org>
Thread-Topic: [TOOLS-DEVELOPMENT] CSS for RFCs SOW
Thread-Index: AQHR4C+UxTN/ZiVcIkWgF5aMP12fFKAc4p8A
Date: Sun, 17 Jul 2016 13:34:40 +0000
Message-ID: <4D481250-BB6C-4C22-A359-78DC47DD4BE5@cisco.com>
References: <C67A7147-8A55-4E68-8B81-2CC2586D85A1@vigilsec.com> <424bc5bb-d32a-d823-54aa-df1f69a3e238@rfc-editor.org> <54BC881A-0B9C-4553-8433-1FB1DADA4E9F@vigilsec.com> <AFE01F67-9610-471E-8458-83B67A212B5E@vigilsec.com> <9b5087f8-8cee-37ee-83d0-77eac13b54da@greenbytes.de> <70427794-113A-4F61-835E-66F5441E4353@vigilsec.com> <27cad5c3-5437-1fb2-3379-b94b1c810176@greenbytes.de> <e70d5df9-f303-1695-9917-78597732caf5@rfc-editor.org> <0cd2457c-7e44-87de-7280-e6f2b81226bb@nostrum.com> <7a0d207b-337b-7d9d-3eae-4af36280d54c@rfc-editor.org>
In-Reply-To: <7a0d207b-337b-7d9d-3eae-4af36280d54c@rfc-editor.org>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-mailer: Apple Mail (2.3124)
x-ms-exchange-messagesentrepresentingtype: 1
x-ms-exchange-transport-fromentityheader: Hosted
x-originating-ip: [10.61.67.21]
Content-Type: text/plain; charset="us-ascii"
Content-ID: <86F9F6B6EBBE9548924DA89789FE98F9@emea.cisco.com>
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-development/WX5nmF1lYx4oUYg6E-pK72M4WTY>
Cc: "tools-development@ietf.org" <tools-development@ietf.org>
Subject: Re: [TOOLS-DEVELOPMENT] CSS for RFCs SOW
X-BeenThere: tools-development@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Tools Development list server <tools-development.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-development>, <mailto:tools-development-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-development/>
List-Post: <mailto:tools-development@ietf.org>
List-Help: <mailto:tools-development-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-development>, <mailto:tools-development-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 17 Jul 2016 13:34:45 -0000

Looks good to me.


> On Jul 17, 2016, at 3:31 PM, Heather Flanagan (RFC Series Editor) <rse@rfc-editor.org> wrote:
> 
> On 7/5/16 10:07 PM, Robert Sparks wrote:
>> 
>> 
>> 
>> On 7/5/16 2:56 PM, Heather Flanagan (RFC Series Editor) wrote:
>> 
>> <trim/>
>> 
>>> 
>>> > 
>>> >>> - it's unclear how designing the CSS has any impact on PDF,
>>> >>> unless we plan to produce the PDF from HTML (which I would
>>> >>> strongly support), in which case mentioning it here doesn't make
>>> >>> a lot of sense
>>> >> 
>>> >> The most recent update to the CSS for RFCs SOW is much more clear
>>> >> on this point.  I think the previous version was fuzzy.
>>> > 
>>> > I just looked and it still talks about PDF all over the place; it's
>>> > totally unclear from the SoW how CSS affects PDF.
>>> 
>>> 
>>> The HTML and PDF need to look very similar, and if the implementer(s) decide to create the PDF from the HTML using all the features described in the PDF draft, then there may well be implications for the CSS. I feel rather strongly that we need to leave the mentions of PDF in this doc. Whoever designs the CSS needs to understand how closely these things will be tied together. 
>> It's probably worth capturing the distinction I think Julian is really looking for.
>> 
>> The CSS designer needs to be aware that we want to create PDF that looks very similar to the way HTML renders.
>> That will constrain the choices the designer makes to those that won't make creating that PDF _hard_.
>> The CSS designer should also be aware that we could choose to render PDF from the HTML, and not make choices that would make that hard.
>> 
>> That captures the connection between the HTML and PDF for the purposes of this document completely I think.
> 
> Does this change in the Overview capture this, do you think?
> 
> This project will result in a CSS file that will reflect visually pleasing, accessible, and responsive design. The HTML follows a semantic design as described in <https://datatracker.ietf.org/doc/draft-iab-html-rfc/>; all display details must come from an embedded CSS. The PDF must also follow a semantic design, including proper PDF tags, as described in <https://datatracker.ietf.org/doc/draft-iab-rfc-use-of-pdf/>. The CSS will be embedded in the HTML; the CSS designer should avoid any feature that is not easily implemented in PDF. The CSS designer should be aware that we may choose to render PDF from the HTML, and so should avoid making any choices in the implementation of the CSS that would make that creating a visually similar PDF difficult.
> 
> 
> (last sentence added)
> -Heather 
> _______________________________________________
> TOOLS-DEVELOPMENT mailing list
> TOOLS-DEVELOPMENT@ietf.org
> https://www.ietf.org/mailman/listinfo/tools-development

-- 
Joe Hildebrand