[要約] RFC 7760は、IETF Datatrackerの拡張機能に関する作業内容と目的を定義しています。このRFCの目的は、著者の統計情報を追加するための仕様を提供することです。

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

著者統計のIETFデータトラッカーの拡張に関する作業明細書

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.

これは、IETF Datatrackerを拡張してRFCとインターネットドラフトおよびその作成者に関する統計を提供するための作業明細書(SOW)です。

Status of This Memo

本文書の状態

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

このドキュメントはInternet Standards Trackの仕様ではありません。情報提供を目的として公開されています。

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.

このドキュメントは、IETF(Internet Engineering Task Force)の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ(IESG)による公開が承認されました。 IESGによって承認されたすべてのドキュメントが、あらゆるレベルのインターネット標準の候補になるわけではありません。 RFC 5741のセクション2をご覧ください。

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.

このドキュメントの現在のステータス、エラッタ、およびフィードバックの提供方法に関する情報は、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.

Copyright(c)2016 IETF Trustおよびドキュメントの作成者として識別された人物。全著作権所有。

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.

この文書は、BCP 78およびIETF文書に関するIETFトラストの法的規定(http://trustee.ietf.org/license-info)の対象であり、この文書の発行日に有効です。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、Trust Legal Provisionsのセクション4.eに記載されているSimplified BSD Licenseのテキストが含まれている必要があり、Simplified BSD Licenseに記載されているように保証なしで提供されます。

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
1. はじめに

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].

IETFコミュニティの著名なメンバーは、RFCおよびインターネットドラフトの作成者に関する統計を作成するための一連のツールを開発しました。これらのツールは、ドキュメント自体を分析して、ドキュメントとその作成者に関する統計を生成します。このドキュメントで説明するIETF Datatrackerの機能強化の目的は、同様の統計を提供し、ソフトウェアがIETF情報サービスの一部として維持されるようにすることです。一部のデータはドキュメント自体から抽出する必要があるかもしれませんが、可能な限り多くのデータをIETF Datatrackerデータベース[DATATRACKER]で維持する必要があります。

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

現在の統計は、http://www.arkko.com/tools/docstats.htmlのWebで入手できます。

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

これらの統計を生成するために使用されるコードは、http://www.arkko.com/tools/authorstats.htmlから入手できます。

2. Purpose
2. 目的

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.

一部の統計は、「知っておくと便利な」情報を提供します。ただし、IETFでの特定の参加者の貢献を参照するために使用されるものや、IETFの作業内の傾向を研究するために使用されるものもあります。たとえば、IETFは参加者の多様性を高めることを試みており、統計はそれらの取り組みの影響を確認する1つの方法です。また、最もアクティブな個人は、さまざまなリーダーシップのポジションの潜在的な候補者です。

3. Statistics
3. 統計学

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

IETF Datatrackerの機能強化により、ドキュメント、ドキュメントの作成者、作成者の所属、作成者の国、および作成者の大陸に関する統計とグラフが提供されます。

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

統計には、現在のツールでは追跡されていないIETF会議の参加者に関する傾向も含める必要があります。

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

これらの要件のために、「最近のインターネットドラフト」と「最近のRFC」は、過去5年間に公開されたドキュメントを対象としています。

3.1. Documents
3.1. 書類

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.

統計は、ドキュメントごとの著者の数への洞察を提供するものとします。現在のWebページには、統計と棒グラフが表示されます。現在のWebページは、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.

統計は、ドキュメントのサイズへの洞察を提供するものとします。現在のWebページには、統計と棒グラフが表示されます。現在のWebページは、http://www.arkko.com/tools/allstats/pagedistr.htmlで確認できます。文書形式の計画的な変更により、文書サイズを測定する他の方法(ワードカウントなど)の方が適切な場合があります。

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.

統計は、ABNF、ASN.1、Cコード、CBOR、JSON、XMLなどのさまざまな仕様手法の使用に関する洞察を提供します。現在のWebページには、これらのテクニックのすべてが含まれているわけではありません。現在のWebページは、http://www.arkko.com/tools/allstats/formatdistr.htmlで確認できます。

3.2. Authors
3.2. 著者

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.

統計は、最近のインターネットドラフト、最近のRFC、およびすべてのRFCについて作成したドキュメントの数に従って、作成者の分布に関する洞察を提供します。同様の情報を提供する現在のWebページには、統計と棒グラフが含まれます。 Webページは、http://www.arkko.com/tools/stats/authactdistr.html、http://www.arkko.com/tools/recrfcstats/authactdistr.html、および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.

統計は、他のRFCで引用されているRFCの数によって、著者の相対的な影響に対する洞察を提供します。現在のWebページは、http://www.arkko.com/tools/rfcstats/hindextop.htmlで確認できます。

3.3. Affiliation of Authors
3.3. 著者の所属

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.

統計は、最近のインターネットドラフト、最近のRFC、およびすべてのRFCに対する著者の所属に関する洞察を提供します。同様の情報を提供する現在のWebページには、統計と棒グラフが含まれます。 Webページは、http://www.arkko.com/tools/allstats/companies.html、http://www.arkko.com/tools/stats/companydistr.html、http://www.arkkoから入手できます。 com / tools / recrfcstats / companydistr.html、および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.

統計は、RFC作成者の所属が長年にわたって変化した方法についての洞察を提供します。現在のWebページは、http://www.arkko.com/tools/rfcstats/companydistrhist.htmlで確認できます。

3.4. Countries of Authors
3.4. 著者の国

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.

統計は、最近のインターネットドラフト、最近のRFC、およびすべてのRFCについて、作成者の国に対する洞察を提供します。国ベースの統計を提供することは有用であり、他の大国との比較のために、欧州連合(EU)を単一の「国」として示す統計を提供することも有用でした。同様の情報を提供する現在のWebページには、統計と棒グラフが含まれます。 Webページは、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、および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.

統計は、国ごとのインターネットドラフトとRFCの作成者数の経時的な変化を示します。現在のWebページは、http://www.arkko.com/tools/rfcstats/countrydistrhist.htmlで確認できます。

3.5. Continents of Authors
3.5. 著者の大陸

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.

統計は、最近のインターネットドラフト、最近のRFC、およびすべてのRFCについて、著者の大陸への洞察を提供します。同様の情報を提供する現在のWebページには、統計と棒グラフが含まれます。 Webページは、http://www.arkko.com/tools/stats/d-contdistr.html、http://www.arkko.com/tools/recrfcstats/d-contdistr.html、および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.

統計は、時間の経過に伴う大陸あたりのインターネットドラフトとRFCの作成者数の変化を示します。現在のページはhttp://www.arkko.com/tools/rfcstats/d-contdistrhist.htmlで見ることができます。

4. IETF Meeting Attendees
4. IETF会議の出席者

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

IETF Datatrackerの機能強化により、IETF会議の参加者の国と大陸に関する統計とグラフが提供されます。

4.1. Countries of IETF Meeting Attendees
4.1. IETF会議の参加国

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".

統計は、各IETF会議の出席者が代表する国についての洞察を提供します。国別の統計は、本会議で長年にわたって発表されてきました。このドキュメントのセクション3で説明されている著者の統計との一貫性を保つために、統計には、他の大国と比較するためにEUを単一の「国」として示す方法が含まれます。各会議の統計には、参加者と「その他」の数が最も多い8か国を示す円グラフを添付する必要があります。

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".

統計は、国ごとのIETF会議の参加者数の経時的な変化を示します。繰り返しになりますが、このドキュメントのセクション3で説明されている著者の統計との整合性のため、統計にはEUを単一の「国」として示す方法が含まれます。

4.2. Continents of IETF Meeting Attendees
4.2. IETF会議の参加者の大陸

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

統計は、各IETF会議の出席者が代表する大陸への洞察を提供します。

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

統計は、大陸ごとのIETF会議出席者数の経時的な変化を示します。

5. Existing Code
5. 既存のコード

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.

新しいコードは可能な限りDatatrackerデータベースによって駆動されるため、既存のコードの価値は限られている可能性があります。既存のコードは一時的なソリューションとして意図されたものであり、書き換えが必要です。ただし、コードで使用される一連のヒューリスティックが役立つ場合があります。これらのヒューリスティックは別のルールデータベースで提供され、情報が少なすぎる場合の最後の手段として使用されます。ヒューリスティックには、著者のエイリアス、一部の認定された著者と一部の認定された所属、場所と所属を決定するためのドメイン名データ、および人々が住所で国を表すいくつかの方法のマッピングが含まれます。

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 database provides a way to capture aliases, but not all of the aliases in the documents have been added to the database.

著者は、さまざまなドキュメントでの名前の表示方法に一貫性がありません。たとえば、あるドキュメントに名前が含まれ、別のドキュメントにニックネームが含まれる場合があります。 Datatrackerデータベースはエイリアスを取得する方法を提供しますが、ドキュメント内のすべてのエイリアスがデータベースに追加されているわけではありません。

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.

現在のDatatrackerデータベースには、現在のツールで使用されている作成者のエイリアス以外のヒューリスティックのテーブルはありません。現在のルールデータベースからの追加のヒューリスティックを保持するための適切なテーブルは、Datatrackerソースコードを管理するグループによって合意された方法でDatatrackerデータベースに追加する必要があります。

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

おそらくDjango Adminを使用して、新しいヒューリスティックテーブルを更新するための実行可能なWebインターフェイスが提供されます。

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

現在のコードはhttp://www.arkko.com/tools/authorstats.htmlにあり、公開されていますが、保証はありません。

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.

ソフトウェアは2つの部分に分かれており、コード自体はヒューリスティックデータベースから分離されています。コードの2つの主要コンポーネントは、統計を生成して統計Webページを生成するauthorstatsと、ドキュメント分析を実行するgetauthorsです。

6. Deployment
6. 配備

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.

現在のツールは、ドキュメント自体を分析して統計を生成します。統計を作成するために必要なデータの一部は、現在Datatrackerデータベースにありません。この開発作業には、このデータをDatatrackerデータベースにキャプチャして、過去5年間に投稿されたすべてのRFCおよびインターネットドラフトにデータを取り込む機能を追加することが含まれます。既存のコードを利用して情報を抽出し、それを1回検証することは、費用効果が高い場合があります。

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.

現在のツールのURLは、Webの多くの場所にあります。適切な代替ツールが利用可能になると、元のツールの作成者は適切な形式のリダイレクトを提供することを約束しました。

7. Thoughts on Future Enhancements
7. 将来の機能強化に関する考え

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.

文書形式の計画的な変更により、ヒューリスティックによって取得された情報の一部は、XMLファイルからより直接的に抽出される可能性があります。このフォーマットがかなりの数の作成者によって使用されると、将来の取り組みは、ヒューリスティックからXMLファイルからの抽出に移行する可能性があります。このアプローチをサポートするには、人間が読めるドキュメントのフォーマットで使用されていない場合でも、新しいXMLスキーマが著者の大陸を利用できるようにすることが望ましいでしょう。

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.

現在、Datatrackerにはドキュメントの作成者に関する情報がありますが、他の投稿者に関する情報はありません。将来、貢献者をカバーする情報がDatatrackerに追加された場合、統計は、貢献者と作成者をカバーするように拡張できます。

8. Security Considerations
8. セキュリティに関する考慮事項

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.

このドキュメントには、IETF Datatrackerを拡張して著者の統計を提供するSOWが含まれています。これらの機能強化は、インターネットのセキュリティには影響しません。機能拡張により、事前認証なしで一般に公開されているドキュメントに関する統計が提供され、統計は事前認証なしでも一般に公開されます。

9. Informative References
9. 参考引用

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

[DATATRACKER]インターネット技術特別調査委員会、「IETF Datatracker」、<https://datatracker.ietf.org/>。

Author's Address

著者のアドレス

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

Russ Housley Vigil Security、LLC 918 Spring Knoll Drive Herndon、VA 20170アメリカ

   Email: housley@vigilsec.com