IETF Logo Mail Archive

Re: [dmarc-ietf] [Gen-art] [Last-Call] Genart last call review of draft-ietf-dmarc-psd-08

"Murray S. Kucherawy" <superuser@gmail.com> Sat, 23 January 2021 04:13 UTC

Return-Path: <superuser@gmail.com>
X-Original-To: dmarc@ietfa.amsl.com
Delivered-To: dmarc@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id E30863A0B3A for <dmarc@ietfa.amsl.com>; Fri, 22 Jan 2021 20:13:19 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.097
X-Spam-Level:
X-Spam-Status: No, score=-2.097 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.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 4QGhNHW-hhfm for <dmarc@ietfa.amsl.com>; Fri, 22 Jan 2021 20:13:18 -0800 (PST)
Received: from mail-vk1-xa2d.google.com (mail-vk1-xa2d.google.com [IPv6:2607:f8b0:4864:20::a2d]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 62F003A0B41 for <dmarc@ietf.org>; Fri, 22 Jan 2021 20:13:18 -0800 (PST)
Received: by mail-vk1-xa2d.google.com with SMTP id q66so1869062vke.0 for <dmarc@ietf.org>; Fri, 22 Jan 2021 20:13:18 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=tc4WniwVZujzhSdC+HKsw0nk9rxeS2uz1vLtMgy/YEw=; b=meSrF8tJs/KeM2Eiv3U06cajiQnohxPqHiu/Q+6o93ZOE8SIYzXgweWqvkUh0SgHGS 8Y0AFmE40qLoHOoqhUhUVeO6ckMXn+7HtppkttLUAZR+q8m0M23SoQd/oHcBucJeEQ5x ygyFEfYVEgIqlfFw5OLTjoaE/CHTfgPZvdhH1yn28eMCTBYvCbXsKY1o3DRYGGl+n7bI svKwIHhqUhb9sBchaPLUxOQjNlWMCfW0V0jsnBy4bUYBabSQp3JXjNehpJtKkXOEbDBR 4N+leFkQR6KLNeFJtBKu/0465LbeHxhI2DUBb8SI0A1wojyy+NoK0y9md7ZSv6/pcpKA 0H6A==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=tc4WniwVZujzhSdC+HKsw0nk9rxeS2uz1vLtMgy/YEw=; b=jQr98B57OCL53rr8JnV+tLRv23HmiSuJ7BEbKsRgNQefREZE4oZmwDlpi7caJxOu68 Af5dlqudQXai+dKkL6/nMyiYtg9tUMnnfX0u/4lMsDTRQlzvHOLN2HX7PrKnZsnXXAKv vUeKmqqmjiOD+hw6a5G8WEYeLr6fzAjW44vSOC3gx07cvskdWwkGxx3PJqZENHTtRCke I4HNO0f+1LQBUSXGDgFdfyFk9yV1UMuDNcuQX+BTL43t7GNVNtkoPJ8GUDbC3SpIkojF gnBkE7wudqAUcHpeZHQlAOv+Es9hr/nMrWS1RyuzKKxln+HXRsBW2deMNweHmXJCCzq3 7etA==
X-Gm-Message-State: AOAM532q4TZjoufGrCQIX0hRqZZB/j6GandVPxqPeN+a6y9GXXVeCdy2 p2k3RR8hbvnx4lTKk4SRIjP4563Xz7nr4QKYfPc=
X-Google-Smtp-Source: ABdhPJy2MWBtFoC0xnl1Wuvx6hXfDqPnjUlq5+9lpnaKa0RLmvsBmmC01uE/+acToyNIjLIfcFpPg4OjJ6+DF0ti8uM=
X-Received: by 2002:a1f:30cd:: with SMTP id w196mr61507vkw.13.1611375197182; Fri, 22 Jan 2021 20:13:17 -0800 (PST)
MIME-Version: 1.0
References: <CADyWQ+Fb93SkiAnL4cuCfxC5Wi1ERLeKhguWqAp3j8YEa6JBSA@mail.gmail.com> <87ima4wu3s.fsf@hobgoblin.ariadne.com> <CAL0qLwbiOrgsEjZU_V6W8e42SRNoUh7CzyngRMR5RLeQpzrxaQ@mail.gmail.com> <44eec884-a3c7-f0e3-4545-1032369ad3fd@tana.it> <CAL0qLwavpE9r6+O+Dm5EyDYzP9_pTpTbbjMzL1mPTyJky5CKmA@mail.gmail.com> <CADyWQ+Hn5G_WSHjrD3gLL5HwZxDGoV_wxgAuiPc_sutQ4OYhNg@mail.gmail.com> <CAL0qLwbhhh8k-1TN6G=UX84v-92fP22=D+Q61OL2zS_9mJmUHg@mail.gmail.com> <CADyWQ+GoHDt=MUo=XeF9Bfi8yO8C1VB=+vynXtV6Ebb900z7sA@mail.gmail.com>
In-Reply-To: <CADyWQ+GoHDt=MUo=XeF9Bfi8yO8C1VB=+vynXtV6Ebb900z7sA@mail.gmail.com>
From: "Murray S. Kucherawy" <superuser@gmail.com>
Date: Fri, 22 Jan 2021 20:13:03 -0800
Message-ID: <CAL0qLwYBzqsS1FMOFEVgCuiKFgAKbUCja0i4361qqvKo+nYbOg@mail.gmail.com>
To: Tim Wicinski <tjw.ietf@gmail.com>
Cc: Alessandro Vesely <vesely@tana.it>, IETF DMARC WG <dmarc@ietf.org>
Content-Type: multipart/alternative; boundary="0000000000003a612605b98986f5"
Archived-At: <https://mailarchive.ietf.org/arch/msg/dmarc/V5Pe8HjZfOK0DkpB4yna60LIGik>
Subject: Re: [dmarc-ietf] [Gen-art] [Last-Call] Genart last call review of draft-ietf-dmarc-psd-08
X-BeenThere: dmarc@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Domain-based Message Authentication, Reporting, and Compliance \(DMARC\)" <dmarc.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/dmarc>, <mailto:dmarc-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/dmarc/>
List-Post: <mailto:dmarc@ietf.org>
List-Help: <mailto:dmarc-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/dmarc>, <mailto:dmarc-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 23 Jan 2021 04:13:20 -0000

On Fri, Jan 22, 2021 at 6:44 PM Tim Wicinski <tjw.ietf@gmail.com> wrote:

> (this is really for Murray)
>
> On Fri, Jan 22, 2021 at 6:25 PM Murray S. Kucherawy <superuser@gmail.com>
> wrote:
>
>>
>> Looks good to me where it is.  I would add "(PSL)", introducing the
>> acronym, right after its first use if we decide to leave it there.
>>
>> A formatting thing to take care of at some point: Anyplace you refer to
>> DMARC, the protocol, just have it as "DMARC" (e.g., "not exempt from DMARC
>> policy"); anyplace you refer to DMARC, the specification (e.g., "Section
>> a.b.c of DMARC" or similar), it should be the <xref target="..."> ...
>> </xref> sorta deal so that it pops out as a reference.
>>
>>
> So the xref for RFC7489 were created of this form:
>
> <xref target="RFC7489">DMARC</xref>
>
> and submitted into the submission system, the HTML document will have this look:
>
>
> DMARC [RFC7489]   (Link is mapped to [RFC7489])
>
> and the HTML is
>
> [<a href="./rfc7489" title="&quot;Domain-based Message Authentication, Reporting, and Conformance (DMARC)&quot;">RFC7489</a>]However, when I run xml2rfc (v3.5.0) locally the
>
>
> However, when I run xml2rfc (v3.5.0) locally, the HTML shows the text "DMARC" as a link
>
> and the HTML is
>
> <a href="#RFC7489" class="xref">DMARC</a>
>
>
> So this makes my brain hurt. I'm going to revisit this in the morning.
>

For the ones that should actually be document references, try just <xref
target="RFC7489"/>.

-MSK

v2.23.0 | Report a Bug | By Email