Loading...

Beyond syntax: unleashing the power of computational notebooks code metrics in documentation generation

Mostafavi Ghahfarokhi, M ; Sharif University of Technology | 2024

78 Viewed
  1. Type of Document: Article
  2. DOI: 10.1145/3644815.3644979
  3. Publisher: 2024
  4. Abstract:
  5. Computational notebooks, like Kaggle notebooks, offer an integrated platform for coding and documentation, yet the latter's quality often falls short as scientists may neglect this crucial aspect. This paper addresses the need for improved and efficient code documentation generation in computational notebooks. As recent literature emphasizes integrating code's inherent structure into documentation generation models, our research explores unutilized structural characteristics, incorporating metrics from code sequences to enable better code documentation suggestions. Evidenced by the improved BLEU scores, our proposed method significantly outperforms the conventional model in a preliminary 10-fold cross-validation experiment and further provides a flexible foundation for integrating source code metrics into diverse code documentation generation models. © 2024 Copyright held by the owner/author(s)
  6. Keywords:
  7. Code metrics ; Computational notebooks ; Markdown generation ; 10-fold cross-validation ; Code metrics ; Code sequences ; Computational notebook ; Conventional modeling ; Flexible foundations ; Integrated platform ; Markdown generation ; Power ; Structural characteristics ; Computer programming
  8. Source: Proceedings - 2024 IEEE/ACM 3rd International Conference on AI Engineering - Software Engineering for AI, CAIN 2024 ; 2024 , Pages 278-279 ; 979-840070591-5 (ISBN)
  9. URL: https://dl.acm.org/doi/10.1145/3644815.3644979