two documentation styles are employed

Some functions are documented using Roxygen2 (i.e. using comments in the R/*.R code) and others are documented in hand-written man/.Rd files. The former always contain a comment at the start warning developers not to edit them.