Statement of Work for Extensions to the IETF Datatracker for Author Statistics
RFC 7760

Internet Engineering Task Force (IETF)                        R. Housley
Request for Comments: 7760                                Vigil Security
Category: Informational                                     January 2016
ISSN: 2070-1721

      Statement of Work for Extensions to the IETF Datatracker for
                           Author Statistics

Abstract

   This is the Statement of Work (SOW) for extensions to the IETF
   Datatracker to provide statistics about RFCs and Internet-Drafts and
   their authors.

Status of This Memo

   This document is not an Internet Standards Track specification; it is
   published for informational purposes.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   Internet Engineering Steering Group (IESG).  Not all documents
   approved by the IESG are a candidate for any level of Internet
   Standard; see Section 2 of RFC 5741.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   http://www.rfc-editor.org/info/rfc7760.

Copyright Notice

   Copyright (c) 2016 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Housley                       Informational                     [Page 1]
RFC 7760                SOW for Author Statistics           January 2016

Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  2
   2.  Purpose  . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
   3.  Statistics . . . . . . . . . . . . . . . . . . . . . . . . . .  3
     3.1.  Documents  . . . . . . . . . . . . . . . . . . . . . . . .  3
     3.2.  Authors  . . . . . . . . . . . . . . . . . . . . . . . . .  4
     3.3.  Affiliation of Authors . . . . . . . . . . . . . . . . . .  4
     3.4.  Countries of Authors . . . . . . . . . . . . . . . . . . .  5
     3.5.  Continents of Authors  . . . . . . . . . . . . . . . . . .  5
   4.  IETF Meeting Attendees . . . . . . . . . . . . . . . . . . . .  6
     4.1.  Countries of IETF Meeting Attendees  . . . . . . . . . . .  6
     4.2.  Continents of IETF Meeting Attendees . . . . . . . . . . .  6
   5.  Existing Code  . . . . . . . . . . . . . . . . . . . . . . . .  6
   6.  Deployment . . . . . . . . . . . . . . . . . . . . . . . . . .  7
   7.  Thoughts on Future Enhancements  . . . . . . . . . . . . . . .  7
   8.  Security Considerations  . . . . . . . . . . . . . . . . . . .  8
   9.  Informative References   . . . . . . . . . . . . . . . . . . .  8
   Author's Address . . . . . . . . . . . . . . . . . . . . . . . . .  8

1.  Introduction

   A prominent member of the IETF community has developed a set of tools
   to produce statistics about the authors of RFCs and Internet-Drafts.
   These tools analyze the documents themselves to produce statistics
   about the documents and their authors.  The goal of the IETF
   Datatracker enhancements described in this document is to provide
   similar statistics and ensure that the software is maintained as part
   of the IETF information services.  While some data may still need to
   be extracted from the documents themselves, as much data as possible
   should be maintained in the IETF Datatracker database [DATATRACKER].

   Current statistics are available on the web at
   http://www.arkko.com/tools/docstats.html.

   The code that is used to produce these statistics is available at
   http://www.arkko.com/tools/authorstats.html.

2.  Purpose

   Author statistics allow the community to understand where work is
   being done and by whom.  The statistics make it visible which
   individuals, companies, and geographic regions are the most active
   contributors.  The statistics also show how these are changing over
   the years.

Housley                       Informational                     [Page 2]
RFC 7760                SOW for Author Statistics           January 2016

   Some of the statistics provide "nice to know" information; however,
   others are sometimes used to refer to a particular participant's
   contributions in the IETF or used to study trends within IETF work.
   For instance, the IETF has been trying to increase the diversity of
   participants, and the statistics are one way to see the impact of
   those efforts.  Also, the most active individuals are potential
   candidates for various leadership positions.

3.  Statistics

   The enhancements to the IETF Datatracker shall provide statistics and
   graphs about documents, document authors, author affiliation, author
   country, and author continent.

   The statistics should also include trends relating to IETF meeting
   attendees, which the current tools do not track.

   For the purposes of these requirements, "recent Internet-Drafts" and
   "recent RFCs" cover documents that have been published in the last
   five years.

3.1.  Documents

   The statistics shall provide insight into the number of authors per
   document.  The current web page presents the statistics and a bar
   chart.  The current web page can be seen at
   http://www.arkko.com/tools/rfcstats/authdistr.html.

   The statistics shall provide insight into the size of the documents.
   The current web page presents the statistics and a bar chart.  The
   current web page can be seen at
   http://www.arkko.com/tools/allstats/pagedistr.html.  With the planned
   change in document format, some other way to measure document size
   might be more appropriate, such as word count.

   Additionally, statistics about the document format that was used by
   the authors should be provided, which is not provided by the current
   tools.

   The statistics shall provide insight into the use of various
   specification techniques such as ABNF, ASN.1, C code, CBOR, JSON, and
   XML.  The current web page does not include all of these techniques.
   The current web page can be seen at
   http://www.arkko.com/tools/allstats/formatdistr.html.

Housley                       Informational                     [Page 3]
RFC 7760                SOW for Author Statistics           January 2016

3.2.  Authors

   The statistics shall provide insight into the distribution of authors
   according to the number of documents they have authored for recent
   Internet-Drafts, recent RFCs, and all RFCs.  The current web pages
   that provide similar information include the statistics and a bar
   chart.  The web pages are available at
   http://www.arkko.com/tools/stats/authactdistr.html,
   http://www.arkko.com/tools/recrfcstats/authactdistr.html, and
   http://www.arkko.com/tools/rfcstats/authactdistr.html.

   The statistics shall provide insight into the relative impact of
   authors by the number of their RFCs that are cited by other RFCs.
   The current web page can be seen at
   http://www.arkko.com/tools/rfcstats/hindextop.html.

3.3.  Affiliation of Authors

   The statistics shall provide insight into the affiliation of authors
   for recent Internet-Drafts, recent RFCs, and all RFCs.  The current
   web pages that provide similar information include the statistics and
   a bar chart.  The web pages are available at
   http://www.arkko.com/tools/allstats/companies.html,
   http://www.arkko.com/tools/stats/companydistr.html,
   http://www.arkko.com/tools/recrfcstats/companydistr.html, and
   http://www.arkko.com/tools/rfcstats/companydistr.html.

   The statistics shall provide insight into the way that affiliations
   of RFC authors have changed over the years.  The current web page can
   be seen at http://www.arkko.com/tools/rfcstats/companydistrhist.html.

Housley                       Informational                     [Page 4]
RFC 7760                SOW for Author Statistics           January 2016

3.4.  Countries of Authors

   The statistics shall provide insight into countries of authors for
   recent Internet-Drafts, recent RFCs, and all RFCs.  It has been
   useful to provide country-based statistics, and it has also been
   useful to provide statistics showing the European Union (EU) as a
   single "country" for the sake of comparison with other large
   countries.  The current web pages that provide similar information
   include the statistics and a bar chart.  The web pages are available
   at http://www.arkko.com/tools/rfcstats/countries.html,
   http://www.arkko.com/tools/stats/d-countrydistr.html,
   http://www.arkko.com/tools/stats/d-countryeudistr.html,
   http://www.arkko.com/tools/stats/countrydistr.html,
   http://www.arkko.com/tools/stats/countryeudistr.html,
   http://www.arkko.com/tools/recrfcstats/d-countrydistr.html,
   http://www.arkko.com/tools/recrfcstats/d-countryeudistr.html,
   http://www.arkko.com/tools/recrfcstats/countrydistr.html,
   http://www.arkko.com/tools/recrfcstats/countryeudistr.html,
   http://www.arkko.com/tools/rfcstats/d-countrydistr.html,
   http://www.arkko.com/tools/rfcstats/d-countryeudistr.html,
   http://www.arkko.com/tools/rfcstats/countrydistr.html, and
   http://www.arkko.com/tools/rfcstats/countryeudistr.html.

   The statistics shall illustrate the change in number of Internet-
   Draft and RFC authors per country over time.  The current web page
   can be seen at
   http://www.arkko.com/tools/rfcstats/countrydistrhist.html.

3.5.  Continents of Authors

   The statistics shall provide insight into continents of authors for
   recent Internet-Drafts, recent RFCs, and all RFCs.  The current web
   pages that provide similar information include the statistics and a
   bar chart.  The web pages are available at
   http://www.arkko.com/tools/stats/d-contdistr.html,
   http://www.arkko.com/tools/recrfcstats/d-contdistr.html, and
   http://www.arkko.com/tools/rfcstats/d-contdistr.html.

   The statistics shall illustrate the change in number of Internet-
   Draft and RFC authors per continent over time.  The current pages can
   be seen at http://www.arkko.com/tools/rfcstats/d-contdistrhist.html.

Housley                       Informational                     [Page 5]
RFC 7760                SOW for Author Statistics           January 2016

4.  IETF Meeting Attendees

   The enhancements to the IETF Datatracker shall provide statistics and
   graphs about the country and continent of IETF meeting participants.

4.1.  Countries of IETF Meeting Attendees

   The statistics shall provide insight into countries represented by
   attendees at each IETF meeting.  Country-based statistics have been
   presented in the plenary session for many years.  For consistency
   with the author statistics discussed in Section 3 of this document,
   the statistics will include a way to show the EU as a single
   "country" for the sake of comparison with other large countries.  The
   statistics for each meeting should be accompanied with a pie chart
   that shows the eight countries with the highest number of attendees
   and "other".

   The statistics shall illustrate the change in number of IETF meeting
   attendees per country over time.  Again, for consistency with the
   author statistics discussed in Section 3 of this document, the
   statistics will include a way to show the EU as a single "country".

4.2.  Continents of IETF Meeting Attendees

   The statistics shall provide insight into continents represented by
   attendees at each IETF meeting.

   The statistics shall illustrate the change in number of IETF meeting
   attendees per continent over time.

5.  Existing Code

   Since the new code will be driven by the Datatracker database to the
   greatest extent possible, the existing code may be of limited value.
   The existing code was intended as a temporary solution and requires a
   rewrite.  However, a set of heuristics used by the code may be
   useful.  These heuristics are provided in a separate rule database
   and are used as a last resort when there is otherwise too little
   information.  The heuristics include author aliases, some recognized
   authors and some recognized affiliations, domain name data for
   determining location and affiliation, and mappings for some ways that
   people represent their countries in a post address.

   Authors are not consistent about the way their names appear in
   various documents.  For example, one document may include their given
   name and another document may include a nickname.  The Datatracker

Housley                       Informational                     [Page 6]
RFC 7760                SOW for Author Statistics           January 2016

   database provides a way to capture aliases, but not all of the
   aliases in the documents have been added to the database.

   The current Datatracker database does not have tables for heuristics
   other than author aliases that are used in the current tool.
   Appropriate tables to hold the additional heuristics from the current
   rule database should be added to the Datatracker database in a manner
   agreed by the group of people that maintain the Datatracker source
   code.

   A workable web interface, possibly using Django Admin, to update the
   new heuristics tables shall be provided.

   The current code can be found at
   http://www.arkko.com/tools/authorstats.html and is openly available
   but without any warranty.

   The software is split in two parts, with the code itself being
   separate from the heuristics database.  The two main components of
   the code are authorstats, which produces the statistics and generates
   the statistics web pages, and getauthors, which performs document
   analysis.

6.  Deployment

   The current tools analyze the documents themselves to produce
   statistics.  Some of the data needed to produce the statistics is not
   currently in the Datatracker database.  This development effort will
   include adding the capability to capture this data in the Datatracker
   database and populate it for all RFCs and Internet-Drafts posted over
   the last five years.  It may be cost-effective to leverage the
   existing code to extract the information and then verify it one time.

   The URLs for the current tools exist in many places in the Web.  Once
   a suitable replacement tool is available, the author of the original
   tools has promised to provide a suitable form of redirection.

7.  Thoughts on Future Enhancements

   With the planned change in document format, some of the information
   obtained through heuristics might be more directly extracted from the
   XML file.  Once this format is being used by a significant number of
   authors, a future effort might move away from heuristics toward
   extraction from the XML file.  To support this approach, it would be
   desirable for the new XML schema to make the author's continent of
   residence available, even if it not used in the formatting of the
   human-readable document.

Housley                       Informational                     [Page 7]
RFC 7760                SOW for Author Statistics           January 2016

   Currently, the Datatracker has information about document authors,
   but not other contributors.  If information is added to the
   Datatracker in the future to cover contributors, then the statistics
   can be expanded to cover contributors as well as authors.

8.  Security Considerations

   This document contains the SOW for enhancements to the IETF
   Datatracker to provide author statistics.  These enhancements do not
   affect the security of the Internet.  The enhancements provide
   statistics about documents that are available to the public without
   prior authentication, and the statistics will also be available to
   the public without prior authentication.

9.  Informative References

   [DATATRACKER] Internet Engineering Task Force, "IETF Datatracker",
                 <https://datatracker.ietf.org/>.

Author's Address

   Russ Housley
   Vigil Security, LLC
   918 Spring Knoll Drive
   Herndon, VA  20170
   United States

   Email: housley@vigilsec.com

Housley                       Informational                     [Page 8]