Guiding Developers to Make Informative Commenting Decisions in Source Code

被引:11
|
作者
Huang, Yuan [1 ]
Jia, Nan [2 ]
Zhou, Qiang [1 ]
Chen, Xiangping [1 ]
Xiong, Yingfei [3 ]
Luo, Xiaonan [1 ]
机构
[1] Sun Yat Sen Univ, Guangzhou, Guangdong, Peoples R China
[2] Hebei GEO Univ, Shijiazhuang, Hebei, Peoples R China
[3] Peking Univ, Beijing, Peoples R China
基金
中国国家自然科学基金;
关键词
D O I
10.1145/3183440.3194960
中图分类号
TP31 [计算机软件];
学科分类号
081202 ; 0835 ;
摘要
Code commenting is a common programming practice of practical importance to help developers review and comprehend source code. However, there is a lack of thorough specifications to help developers make their commenting decisions in current practice. To reduce the effort of making commenting decisions, we propose a novel method, CommentSuggester, to guide developers regarding appropriate commenting locations in the source code. We extract context information of source code and employ machine learning techniques to identify possible commenting locations in the source code. The encouraging experimental results demonstrated the feasibility and effectiveness of our commenting suggestion method.
引用
收藏
页码:260 / 261
页数:2
相关论文
共 36 条
  • [1] Investigating Novice Developers' Code Commenting Trends Using Machine Learning Techniques
    Niazi, Tahira
    Das, Teerath
    Ahmed, Ghufran
    Waqas, Syed Muhammad
    Khan, Sumra
    Khan, Suleman
    Abdelatif, Ahmed Abdelaziz
    Wasi, Shaukat
    [J]. ALGORITHMS, 2023, 16 (01)
  • [2] Commenting source code: is it worth it for small programming tasks?
    Sebastian Nielebock
    Dariusz Krolikowski
    Jacob Krüger
    Thomas Leich
    Frank Ortmeier
    [J]. Empirical Software Engineering, 2019, 24 : 1418 - 1457
  • [3] Commenting source code: is it worth it for small programming tasks?
    Nielebock, Sebastian
    Krolikowski, Dariusz
    Krueger, Jacob
    Leich, Thomas
    Ortmeier, Frank
    [J]. EMPIRICAL SOFTWARE ENGINEERING, 2019, 24 (03) : 1418 - 1457
  • [4] CommtPst: Deep learning source code for commenting positions prediction
    Huang, Yuan
    Hu, Xinyu
    Jia, Nan
    Chen, Xiangping
    Zheng, Zibin
    Luo, Xiapu
    [J]. JOURNAL OF SYSTEMS AND SOFTWARE, 2020, 170
  • [5] Learning to Log: Helping Developers Make Informed Logging Decisions
    Zhu, Jieming
    He, Pinjia
    Fu, Qiang
    Zhang, Hongyu
    Lyu, Michael R.
    Zhang, Dongmei
    [J]. 2015 IEEE/ACM 37TH IEEE INTERNATIONAL CONFERENCE ON SOFTWARE ENGINEERING, VOL 1, 2015, : 415 - 425
  • [6] Identifying Effective Pedagogical Practices for Commenting Computer Source Code
    DePasquale, Peter J.
    Locasto, Michael E.
    Kaczmarczyk, Lisa C.
    [J]. SIGCSE 12: PROCEEDINGS OF THE 43RD ACM TECHNICAL SYMPOSIUM ON COMPUTER SCIENCE EDUCATION, 2011, : 678 - 678
  • [7] Would You Fix This Code for Me? Effects of Repair Source and Commenting on Trust in Code Repair
    Alarcon, Gene M.
    Walter, Charles
    Gibson, Anthony M.
    Gamble, Rose F.
    Capiol, August
    Jessup, Sarah A.
    Ryan, Tyler J.
    [J]. SYSTEMS, 2020, 8 (01): : 1 - 17
  • [8] Motivations for Open Source Project Participation and Decisions of Software Developers
    Dongryul Lee
    Byung Cho Kim
    [J]. Computational Economics, 2013, 41 : 31 - 57
  • [9] Motivations for Open Source Project Participation and Decisions of Software Developers
    Lee, Dongryul
    Kim, Byung Cho
    [J]. COMPUTATIONAL ECONOMICS, 2013, 41 (01) : 31 - 57
  • [10] "The Text Comes First" - Principles Guiding EFL Materials Developers' Vocabulary Content Decisions
    Bergstrom, Denise
    Norberg, Cathrine
    Nordlund, Marie
    [J]. SCANDINAVIAN JOURNAL OF EDUCATIONAL RESEARCH, 2023, 67 (01) : 154 - 168