The Document Citation Tool is (somewhat) broken

Ole Jacobsen <olejacobsen@me.com> Mon, 28 June 2021 18:36 UTC

Return-Path: <olejacobsen@me.com>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id BD2E73A1545 for <ietf@ietfa.amsl.com>; Mon, 28 Jun 2021 11:36:29 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 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_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=me.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 9F_7YdrmA5jw for <ietf@ietfa.amsl.com>; Mon, 28 Jun 2021 11:36:26 -0700 (PDT)
Received: from mr85p00im-ztdg06011201.me.com (mr85p00im-ztdg06011201.me.com [17.58.23.181]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D55993A1541 for <ietf@ietf.org>; Mon, 28 Jun 2021 11:36:26 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=me.com; s=1a1hai; t=1624905386; bh=u4a5nIvWK4Om8peksbD6zfKV5l2itIvHISzRiAttq2o=; h=From:Content-Type:Mime-Version:Subject:Message-Id:Date:To; b=lPC8P84wkJc+5LqYld8XfEPWhXC7zf7+/ML2ipKTo4c7jk/0C7MxXGZ7nFYOjFKQa GpfOu0VkHTs6ehDBKGuosH8n9X6MxydYf7EPTU2HXulyYd1Zt2oGpbEXxLRn7cvyoE tG7StavCJHGXBGW5PQEPu2UAMLF4AWLPQPM9YkxFzTcgE3NnJpvC7Q5mfNg+Yh5QcF Umyhd3oM4Vsva/DoKtsevJzLzmzrdIJRrr0Nf2DBEGgWm5JF2wUhD2YANs6rIh1GjJ NlKxdzTq7mUF2+/22mn7PxPWpgq72DxnrIu5RopSqsUuhjtjfyUQE51scQjMAvTTuO CBY4QAqGX2nyg==
Received: from smtpclient.apple (157-131-155-250.fiber.dynamic.sonic.net [157.131.155.250]) by mr85p00im-ztdg06011201.me.com (Postfix) with ESMTPSA id 452734002A2; Mon, 28 Jun 2021 18:36:26 +0000 (UTC)
From: Ole Jacobsen <olejacobsen@me.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_187D4456-A71E-4DEF-A643-1FBCF0FCEEE9"
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.100.0.2.22\))
Subject: The Document Citation Tool is (somewhat) broken
Message-Id: <1391A159-DD66-413D-BD49-F18056583BE5@me.com>
Date: Mon, 28 Jun 2021 11:36:25 -0700
To: ietf@ietf.org
X-Mailer: Apple Mail (2.3654.100.0.2.22)
X-Proofpoint-Virus-Version: vendor=fsecure engine=1.1.170-22c6f66c430a71ce266a39bfe25bc2903e8d5c8f:6.0.391,18.0.790,17.0.607.475.0000000 definitions=2021-06-28_12:2021-06-25_02,2021-06-28_12,2020-04-07_01 signatures=0
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 spamscore=0 malwarescore=0 bulkscore=0 clxscore=1015 phishscore=0 adultscore=0 suspectscore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2106280121
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/D2SSmVY6l4pKLwot93kAXe-Z9wE>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 28 Jun 2021 18:36:30 -0000

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/ <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!

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