Re: [Tools-discuss] The Document Citation Tool is (somewhat) broken

Jay Daley <jay@ietf.org> Mon, 28 June 2021 20:00 UTC

Return-Path: <jay@ietf.org>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2138C3A0D64; Mon, 28 Jun 2021 13:00:54 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 Qx4liCICuUCi; Mon, 28 Jun 2021 13:00:50 -0700 (PDT)
Received: from smtpclient.apple (unknown [158.140.230.105]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPSA id 59AEA3A0D85; Mon, 28 Jun 2021 13:00:49 -0700 (PDT)
Content-Type: text/plain; charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.100.0.2.22\))
From: Jay Daley <jay@ietf.org>
In-Reply-To: <1391A159-DD66-413D-BD49-F18056583BE5@me.com>
Date: Tue, 29 Jun 2021 08:00:46 +1200
Cc: Tools Discussion <tools-discuss@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <04FA17DA-3A85-422B-B181-F88D278A1135@ietf.org>
References: <1391A159-DD66-413D-BD49-F18056583BE5@me.com>
To: Ole Jacobsen <olejacobsen=40me.com@dmarc.ietf.org>
X-Mailer: Apple Mail (2.3654.100.0.2.22)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/IUbTJjXlryvedjNuQKASrPM7ezc>
Subject: Re: [Tools-discuss] The Document Citation Tool is (somewhat) broken
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 28 Jun 2021 20:00:55 -0000

(moving discussion to tools-discuss)

Ole

> On 29/06/2021, at 6:36 AM, Ole Jacobsen <olejacobsen=40me.com@dmarc.ietf.org> wrote:
> 
> 
> Hi,
> 
> Several years ago, Henrik set up this wonderful tool that creates citations for
> IETF documents (IDs and RFCs) in a standard format. The tool is customizable
> and lives here:
> 
> https://tools.ietf.org/tools/citation/
> 
> Enter, for example, "7575" in the box and you get:
> 
> Clemm, A., Behringer, M., Jiang, S., Pritikin, M., Ciavaglia, L., Bjarnason, S., and B. Carpenter,
> "Autonomic Networking: Definitions and Design Goals," RFC 7575, June 2015.
> 
> It's something I use often to get a consistent list of references in
> articles.
> 
> But, sadly, something is currently broken with this tool, or I suspect something has
> changed in the back-end (datatracker or tools?) whereby recent RFCs are not recognized,
> for example: RFC 8890 gives me: "Could not find author data for document 'rfc8990'"
> 
> And worse: RFC 8995 returns: "An error occurred at this point in the web-page generation.
> An error report has been sent to the webmaster. If this error isn't fixed within 48 hours,
> please contact the web page author directly at webmaster@tools.ietf.org."
> 
> I know Henrik is probably no longer maintaining this tool so I am not blaming him
> or expecting him to fix it, but perhaps someone from the tools/datatracker group could
> take a look at this? It really is a VERY nice tool and I would hate to see it disabled
> forever.
> 
> Thanks in advance!

An RFP was recently awarded [1] for a replacement for the citation library generation and access (API and web page) tool. Unfortunately, when writing that RFP I didn’t know about this specific tool and so it is not listed as a deliverable.  However, it should be relatively straightforward to add simple output of this format, though a fully programmable output format is more complex and I’m not sure it is necessary.  Do you use that programmable output functionality?

Jay

[1] https://mailarchive.ietf.org/arch/msg/ietf-announce/XPvRg0vSCWUBaSxtX1jSVtsNb3I/

> 
> Ole
> 
> 
> Ole J. Jacobsen
> Editor and Publisher
> The Internet Protocol Journal
> Office: +1 415-550-9433
> Cell:   +1 415-370-4628
> Web: protocoljournal.org
> E-mail: olejacobsen@me.com
> E-mail: ole@protocoljournal.org
> Skype: organdemo
> 
> 

-- 
Jay Daley
IETF Executive Director
jay@ietf.org