| Item type |
Trans(1) |
| 公開日 |
2015-12-04 |
| タイトル |
|
|
タイトル |
単体テストを用いたチュートリアルの自動生成手法 |
| タイトル |
|
|
言語 |
en |
|
タイトル |
Automatic Generation of Tutorial from Unit Tests |
| 言語 |
|
|
言語 |
jpn |
| キーワード |
|
|
主題Scheme |
Other |
|
主題 |
[通常論文] 開発支援，ドキュメント，チュートリアル，単体テスト |
| 資源タイプ |
|
|
資源タイプ識別子 |
http://purl.org/coar/resource_type/c_6501 |
|
資源タイプ |
journal article |
| 著者所属 |
|
|
|
東京大学大学院 |
| 著者所属 |
|
|
|
東京大学大学院 |
| 著者所属 |
|
|
|
東京大学大学院 |
| 著者所属(英) |
|
|
|
en |
|
|
The University of Tokyo |
| 著者所属(英) |
|
|
|
en |
|
|
The University of Tokyo |
| 著者所属(英) |
|
|
|
en |
|
|
The University of Tokyo |
| 著者名 |
三上, 裕明
坂本, 大介
五十嵐, 健夫
|
| 著者名(英) |
Hiroaki, Mikami
Daisuke, Sakamoto
Takeo, Igarashi
|
| 論文抄録 |
|
|
内容記述タイプ |
Other |
|
内容記述 |
APIの理解と使い方の学習は，プログラマにとって重要であるが，時間のかかる作業である．APIを理解するための方法の1つとして，チュートリアルがある．チュートリアルは，複数のサンプルコードおよびその説明と，それらのリストからなるドキュメントであり，ライブラリの基本的な機能の使い方を提示する．現在，チュートリアルはライブラリの開発者が記述しているが，チュートリアルを書くことは手間がかかる作業である．そのため，チュートリアルが更新されず，最新のAPIの使い方がチュートリアルで説明されていない場合がある．この問題に対処するため，本論文では，単体テストからチュートリアルを自動的に生成する手法を提案する．本手法では最初に，単体テストから実行可能なサンプルを生成する．次に，サンプルの説明を生成するために，プログラム可視化の技法を用いる．また，サンプルコードのリストを作るために，単体テスト間の依存関係を用いる．具体的には，実行時情報を用いて単体テストの依存関係を抽出し，そしてその依存関係をもとにサンプルコードを順序付けする．本手法の有効性を確認するためにユーザスタディを実施した．この結果，本手法を用いて生成されたチュートリアルを用いることで，自動生成された既存のAPIドキュメントの場合よりもAPIを効率的に理解できるという結果が得られた． |
| 論文抄録(英) |
|
|
内容記述タイプ |
Other |
|
内容記述 |
Understanding and learning the usage of the APIs are important for programmers, but those are time-consuming tasks. A tutorial is one way to understand the usage of the APIs. It is a document composed of some sample codes, their explanations and a list of sample codes, and describes the basic usage of the library. Tutorials are usually written by library-developers; however, writing a tutorial is a tedious work. Therefore, there are cases that how to use the latest APIs is not described in a tutorial because developers do not update the tutorial. To deal with this issue, we present a method that automatically generates a tutorial from unit tests. This method first generates executable sample codes from unit tests. It then uses program visualization technique to explain the sample codes. Furthermore, it uses the dependencies between tests to make a list of sample codes: it extracts the dependencies between tests by using run-time information, and generates the order of the sample codes by using those dependencies. The results of a user study showed that tutorials generated by this method are more effective in helping programmers learn APIs than the existing auto-generated document. |
| 書誌レコードID |
|
|
収録物識別子タイプ |
NCID |
|
収録物識別子 |
AA11464814 |
| 書誌情報 |
情報処理学会論文誌プログラミング（PRO）
巻 8,
号 4,
p. 1-14,
発行日 2015-12-04
|
| ISSN |
|
|
収録物識別子タイプ |
ISSN |
|
収録物識別子 |
1882-7802 |
| 出版者 |
|
|
言語 |
ja |
|
出版者 |
情報処理学会 |
IPSJ-TPRO0804004.pdf (2.4 MB)
