vijaybarve / taxotools

Tools to Handle Taxonomic Lists
5 stars 1 forks source link

\dontrun{} should only be used if the example really cannot be executed #138

Closed vijaybarve closed 1 year ago

vijaybarve commented 2 years ago

\dontrun{} should only be used if the example really cannot be executed (e.g. because of missing additional software, missing API keys, ...) by the user. That's why wrapping examples in \dontrun{} adds the comment ("# Not run:") as a warning for the user. Does not seem necessary in all cases. Please unwrap the examples if they are executable in < 5 sec, or replace \dontrun{} with \donttest{}.