Я считаю, что документация R важна, но также требует много времени для создания/поддержки. Кто-нибудь использовал Roxygen, и если да, то помогает ли он поддерживать пакет R? Я использовал Doxygen в прошлом, но в этих проектах не было структуры человека, которую требуют пакеты R.
Вы можете найти виньетку здесь.
Да, я использую его все время (в пяти пакетах и подсчете). Это фантастика! С его помощью мне удалось создать полный пакет R (stringr) примерно через пять часов.
Недавно я представил патч, чтобы получить 10-кратное ускорение, что делает его еще приятнее использовать.
Я бы хотел начать использовать его, но насколько я знаю, он еще не поддерживает классы S4, которые я широко использую.