-
Wait, wasn't that code here before? Detecting Outdated Software Documentation
Authors:
Wen Siang Tan,
Markus Wagner,
Christoph Treude
Abstract:
Encountering outdated documentation is not a rare occurrence for developers and users in the software engineering community. To ensure that software documentation is up-to-date, developers often have to manually check whether the documentation needs to be updated whenever changes are made to the source code. In our previous work, we proposed an approach to automatically detect outdated code elemen…
▽ More
Encountering outdated documentation is not a rare occurrence for developers and users in the software engineering community. To ensure that software documentation is up-to-date, developers often have to manually check whether the documentation needs to be updated whenever changes are made to the source code. In our previous work, we proposed an approach to automatically detect outdated code element references in software repositories and found that more than a quarter of the 1000 most popular projects on GitHub contained at least one outdated reference. In this paper, we present a GitHub Actions tool that builds on our previous work's approach that GitHub developers can configure to automatically scan for outdated code element references in their GitHub project's documentation whenever a pull request is submitted.
△ Less
Submitted 9 July, 2023;
originally announced July 2023.
-
Excited Hydroxyl Outflow in the High-Mass Star-Forming Region G34.26+0.15
Authors:
W. S. Tan,
E. D. Araya,
C. Rigg,
P. Hofner,
S. Kurtz,
H. Linz,
V. Rosero
Abstract:
G34.26+0.15 is a region of high-mass star formation that contains a broad range of young stellar objects in different stages of evolution, including a hot molecular core, hyper-compact HII regions and a prototypical cometary ultra-compact HII region. Previous high-sensitivity single dish observations by our group resulted in the detection of broad 6035 MHz OH absorption in this region; the line sh…
▽ More
G34.26+0.15 is a region of high-mass star formation that contains a broad range of young stellar objects in different stages of evolution, including a hot molecular core, hyper-compact HII regions and a prototypical cometary ultra-compact HII region. Previous high-sensitivity single dish observations by our group resulted in the detection of broad 6035 MHz OH absorption in this region; the line showed a significant blue-shifted asymmetry indicative of molecular gas expansion. We present high-sensitivity Karl G. Jansky Very Large Array (VLA) observations of the 6035 MHz OH line conducted to image the absorption and investigate its origin with respect to the different star formation sites in the region. In addition, we report detection of 6030 MHz OH absorption with the VLA and further observations of 4.7 GHz and 6.0 GHz OH lines obtained with the Arecibo Telescope. The 6030 MHz OH line shows a very similar absorption profile as the 6035 MHz OH line. We found that the 6035 MHz OH line absorption region is spatially unresolved at $\sim 2$" scales, and it is coincident with one of the bright ionized cores of the cometary HII region that shows broad radio recombination line emission. We discuss a scenario where the OH absorption is tracing the remnants of a pole-on molecular outflow that is being ionized inside-out by the ultra-compact HII region.
△ Less
Submitted 12 June, 2023;
originally announced June 2023.
-
Detecting Outdated Code Element References in Software Repository Documentation
Authors:
Wen Siang Tan,
Markus Wagner,
Christoph Treude
Abstract:
Outdated documentation is a pervasive problem in software development, preventing effective use of software, and misleading users and developers alike. We posit that one possible reason why documentation becomes out of sync so easily is that developers are unaware of when their source code modifications render the documentation obsolete. Ensuring that the documentation is always in sync with the s…
▽ More
Outdated documentation is a pervasive problem in software development, preventing effective use of software, and misleading users and developers alike. We posit that one possible reason why documentation becomes out of sync so easily is that developers are unaware of when their source code modifications render the documentation obsolete. Ensuring that the documentation is always in sync with the source code takes considerable effort, especially for large codebases. To address this situation, we propose an approach that can automatically detect code element references that survive in the documentation after all source code instances have been deleted. In this work, we analysed over 3,000 GitHub projects and found that most projects contain at least one outdated code element reference at some point in their history. We submitted GitHub issues to real-world projects containing outdated references detected by our approach, some of which have already led to documentation fixes. As an initiative toward kee** documentation in software repositories up-to-date, we have made our implementation available for developers to scan their GitHub projects for outdated code element references.
△ Less
Submitted 2 December, 2022;
originally announced December 2022.
-
Thermal Formaldehyde Emission in NGC7538 IRS1
Authors:
Onic I. Shuvo,
E. D. Araya,
W. S. Tan,
P. Hofner,
S. Kurtz,
Y. M. Pihlstrom,
I. M. Hoffman
Abstract:
Spectral lines from formaldehyde (H2CO) molecules at cm wavelengths are typically detected in absorption and trace a broad range of environments, from diffuse gas to giant molecular clouds. In contrast, thermal emission of formaldehyde lines at cm wavelengths is rare. In previous observations with the 100m Robert C. Byrd Green Bank Telescope (GBT), we detected 2 cm formaldehyde emission toward NGC…
▽ More
Spectral lines from formaldehyde (H2CO) molecules at cm wavelengths are typically detected in absorption and trace a broad range of environments, from diffuse gas to giant molecular clouds. In contrast, thermal emission of formaldehyde lines at cm wavelengths is rare. In previous observations with the 100m Robert C. Byrd Green Bank Telescope (GBT), we detected 2 cm formaldehyde emission toward NGC7538 IRS1 - a high-mass protostellar object in a prominent star-forming region of our Galaxy. We present further GBT observations of the 2 cm and 1 cm H2CO lines to investigate the nature of the 2 cm H2CO emission. We conducted observations to constrain the angular size of the 2 cm emission region based on a East-West and North-South cross-scan map. Gaussian fits of the spatial distribution in the East-West direction show a deconvolved size (at half maximum) of the 2 cm emission of 50" +/- 8". The 1 cm H2CO observations revealed emission superimposed on a weak absorption feature. A non-LTE radiative transfer analysis shows that the H2CO emission is consistent with quasi-thermal radiation from dense gas (~10^5 to 10^6 cm^-3). We also report detection of 4 transitions of CH3OH (12.2, 26.8, 28.3, 28.9 GHz), the (8,8) transition of NH3 (26.5 GHz), and a cross-scan map of the 13 GHz SO line that shows extended emission (> 50").
△ Less
Submitted 26 March, 2021;
originally announced March 2021.
-
High-Sensitivity Observations of Molecular Lines with the Arecibo Telescope
Authors:
W. S. Tan,
E. D. Araya,
L. E. Lee,
P. Hofner,
S. Kurtz,
H. Linz,
L. Olmi
Abstract:
We report on one of the highest sensitivity surveys for molecular lines in the frequency range 6.0 to 7.4 GHz conducted to date. The observations were done with the 305m Arecibo Telescope toward a sample of twelve intermediate/high-mass star forming regions. We searched for a large number of transitions of different molecules, including CH3OH and OH. The low RMS noise of our data (~5 mJy for most…
▽ More
We report on one of the highest sensitivity surveys for molecular lines in the frequency range 6.0 to 7.4 GHz conducted to date. The observations were done with the 305m Arecibo Telescope toward a sample of twelve intermediate/high-mass star forming regions. We searched for a large number of transitions of different molecules, including CH3OH and OH. The low RMS noise of our data (~5 mJy for most sources and transitions) allowed detection of spectral features that have not been seen in previous lower sensitivity observations of the sources, such as detection of excited OH and 6.7 GHz CH3OH absorption. A review of 6.7 GHz CH3OH detections indicates an association between absorption and radio continuum sources in high-mass star forming regions, although selection biases in targeted projects and low sensitivity of blind surveys imply incompleteness. Absorption of excited OH transitions was also detected toward three sources. In particular, we confirm a broad 6.035 GHz OH absorption feature in G34.26+0.15 characterized by an asymmetric blue-shifted wing indicative of expansion, perhaps a large scale outflow in this HII region.
△ Less
Submitted 21 June, 2020;
originally announced June 2020.