dials icon indicating copy to clipboard operation
dials copied to clipboard

Uneven documentation of parameters

Open EmilHvitfeldt opened this issue 4 years ago • 0 comments

There is not a lot of documentation for the parameter functions. This is understandable since there isn't a lot to say many times. However, there are still some discrepancies. Here are some documentations that are handled differently

https://dials.tidymodels.org/reference/Laplace.html

https://dials.tidymodels.org/reference/all_neighbors.html

https://dials.tidymodels.org/reference/c5_parameters.html

I would think that the minimum standard should be

  • description
  • arguments description
  • return value
  • examples

As a plus, it would be nice to have details concerning what they do like Laplace()

This parameter is often used to correct for zero-count data in tables or proportions.

But it can also be nice to list some of the places where the parameter is used. Although this might be hard due to dependency issues to make work with linking.

EmilHvitfeldt avatar Apr 20 '21 20:04 EmilHvitfeldt