Document details on null_model

[jxu]

https://parsnip.tidymodels.org/reference/null_model.html

There are several different plausible null models. For classification, besides predicting the majority class, there is also uniform random guessing, and selecting a class from a random input observation. See https://machinelearningmastery.com/how-to-develop-and-evaluate-naive-classifier-strategies-using-probability/

I'm not saying these need to be supported, but I had to look into the source code to see what is actually being fit. The source code clearly says "Fit a single mean or largest class model.", so this should be documented.

[EmilHvitfeldt]

Hello @jxu 👋

thanks for raising this issue, the documentation is indeed quite sparse

[jxu]

I can open a PR if you'd like. I assume

parsnip/R/nullmodel.R

Line 1 in 907d216

#' Fit a simple, non-informative model

is for nullmodel while

parsnip/R/nullmodel.R

Line 128 in 907d216

#' Null model

is for null_model? The naming is a bit confusing.

[EmilHvitfeldt]

it is for the second one! https://github.com/tidymodels/parsnip/blob/HEAD/R/nullmodel.R#L128-L145

Yes the naming is a pain, but this is the only model that is define inside a parsnip package and making the names work with dispatch caused a bit of trouble.

if you are up for a PR go ahead!