INTERNET-DRAFT R. Housley Intended Status: Informational Vigil Security Expires: 23 March 2016 23 September 2015 Statement of Work for Extensions to the IETF Datatracker for Author Statistics draft-housley-sow-author-statistics-01 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 Internet-Draft is submitted to IETF in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/1id-abstracts.html The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html Housley Expires 23 March 2016 [Page 1]
INTERNET-DRAFT SOW for Author Statistics 23 September 2015 Copyright and License Notice Copyright (c) 2015 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. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 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 . . . . . . . . . . . . . . . . . . . . 5 4.1. Countries of IETF Meeting Attendees . . . . . . . . . . . 6 4.2. Continents of IETF Meeting Attendees . . . . . . . . . . . 6 5. Existing Code . . . . . . . . . . . . . . . . . . . . . . . . 6 6. Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7. Security Considerations . . . . . . . . . . . . . . . . . . . 7 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 7 Author 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 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 come from the IETF Datatracker database. Housley Expires 23 March 2016 [Page 2]
INTERNET-DRAFT SOW for Author Statistics 23 September 2015 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. 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. Housley Expires 23 March 2016 [Page 3]
INTERNET-DRAFT SOW for Author Statistics 23 September 2015 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. 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, and 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 distribution of authors according to the number of documents they have authored for recent Internet-Drafts, recent RFCs, and all RFCs. 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, and 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 affiliation of RFC authors has changed over the years. The current web page can be seen at http://www.arkko.com/tools/rfcstats/companydistrhist.html. Housley Expires 23 March 2016 [Page 4]
INTERNET-DRAFT SOW for Author Statistics 23 September 2015 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, and 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 provide insight into the way that countries of RFC authors has changed over the years. 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, and 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 provide insight into the way that continents of RFC authors has changed over the years. The current pages can be seen at http://www.arkko.com/tools/rfcstats/d-contdistrhist.html. 4. IETF Meeting Attendees The enhancements to the IETF Datatracker shall provide statistics and graphs about country and continent of IETF meeting participants. Housley Expires 23 March 2016 [Page 5]
INTERNET-DRAFT SOW for Author Statistics 23 September 2015 4.1. Countries of IETF Meeting Attendees The statistics shall provide insight into countries of IETF meeting attendees for each 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 of showing 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 top eight countries and "other". The statistics shall provide insight into the way that the countries of IETF meeting attendees has changed over the years. Again, for consistency with the author statistics discussed in Section 3 of this document, the statistics will include a way of showing the EU as a single "country". 4.2. Continents of IETF Meeting Attendees The statistics shall provide insight into continents of IETF meeting attendees for each meeting. The statistics shall provide insight into the way that the continents of IETF meeting attendees has changed over the years. 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 also 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 name appears in various document. For example, one document may include their given name and another document may include a nickname. The Datatracker 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 Housley Expires 23 March 2016 [Page 6]
INTERNET-DRAFT SOW for Author Statistics 23 September 2015 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 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 the 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. 8. Security Considerations This document contains the statement of work (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 Housley Expires 23 March 2016 [Page 7]
INTERNET-DRAFT SOW for Author Statistics 23 September 2015 be available to the public without prior authentication. 9. IANA Considerations No changes to the IANA registries are suggested by this document. Author Address Russ Housley Vigil Security, LLC 918 Spring Knoll Drive Herndon, VA 20170 USA Email: housley@vigilsec.com Housley Expires 23 March 2016 [Page 8]