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

[Jay Daley <[e-mail]>]

> On 29/06/2021, at 8:05 AM, Ole Jacobsen <[e-mail]> wrote:
> 
> Hi Jay,
> 
> I only use the two output options:
> 
> {authors.andlist}, "{doctitle}," {date:%B %Y}, {docname}.
> 
> and
> 
> {authors.rfclist}, "{doctitle}," {docname}, {date:%B %Y}.
> 
> ... although I usually set both the the first option {authors.andlist}
> and would be more than happy if that was the only option.
> 
> Thanks for looking into this!
> 
> And: In the interim, perhaps something changed "behind the scenes" that causes this
> problem that could be fixed?

Out of our control and unlikely - sorry.  

Jay

> 
> Ole
> 
> 
>> On Jun 28, 2021, at 13:00, Jay Daley <[e-mail]> wrote:
>> 
>> (moving discussion to tools-discuss)
>> 
>> Ole
>> 
>>> On 29/06/2021, at 6:36 AM, Ole Jacobsen <olejacobsen=[e-mail]> 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 [e-mail]."
>>> 
>>> 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: [phone]
>>> Cell:   [phone]
>>> Web: protocoljournal.org
>>> E-mail: [e-mail]
>>> E-mail: [e-mail]
>>> Skype: organdemo
>>> 
>>> 
>> 
>> -- 
>> Jay Daley
>> IETF Executive Director
>> [e-mail]
>> 
> 
> Ole J. Jacobsen
> Editor and Publisher
> The Internet Protocol Journal
> Office: [phone]
> Cell:   [phone]
> Web: protocoljournal.org <http://protocoljournal.org/>
> E-mail: [e-mail] <mailto:[e-mail]>
> E-mail: [e-mail] <mailto:[e-mail]>
> Skype: organdemo

-- 
Jay Daley
IETF Executive Director
[e-mail]