renamed _make_evaluate_args_and_kwargs to

`gen_evaluator_call_with_types` + added docs, as requested by my dear @willtebbutt

Author: torfjelde

docs/src/api.md

@@ -219,6 +219,12 @@ DynamicPPL.DebugUtils.model_warntype
 DynamicPPL.DebugUtils.model_typed
 ```
 
+Interally, the type-checking methods make use of the following method for construction of the call with the argument types:
+
+```@docs
+DynamicPPL.DebugUtils.gen_evaluator_call_with_types
+```
+
 ## Advanced
 
 ### Variable names

src/debug_utils.jl

@@ -679,7 +679,27 @@ function has_static_constraints(
     return all_the_same(transforms)
 end
 
-function _make_evaluate_args_and_kwargs(model, varinfo, context)
+"""
+    gen_evaluator_call_with_types(model[, varinfo, context])
+
+Generate the evaluator call and the types of the arguments.
+
+# Arguments
+- `model::Model`: The model whose evaluator is of interest.
+- `varinfo::AbstractVarInfo`: The varinfo to use when evaluating the model. Default: `VarInfo(model)`.
+- `context::AbstractContext`: The context to use when evaluating the model. Default: [`DefaultContext`](@ref).
+
+# Returns
+A 2-tuple with the following elements:
+- `ftype::Type`: The function type of the evaluator. This is either `model.f` or `Core.kwcall`, depending on whether
+    the model has keyword arguments.
+- `argtypes::Type{<:Tuple}`: The types of the arguments for the evaluator.
+"""
+function gen_evaluator_call_with_types(
+    model::Model,
+    varinfo::AbstractVarInfo=VarInfo(model),
+    context::AbstractContext=DefaultContext()
+)
     args, kwargs = DynamicPPL.make_evaluate_args_and_kwargs(model, varinfo, context)
     return if isempty(kwargs)
         (model.f, Base.typesof(args...))
@@ -709,7 +729,7 @@ function model_warntype(
     context::AbstractContext=DefaultContext();
     optimize::Bool=false,
 )
-    ftype, argtypes = _make_evaluate_args_and_kwargs(model, varinfo, context)
+    ftype, argtypes = gen_evaluator_call_with_types(model, varinfo, context)
     return InteractiveUtils.code_warntype(ftype, argtypes; optimize=optimize)
 end
 
@@ -734,7 +754,7 @@ function model_typed(
     context::AbstractContext=DefaultContext();
     optimize::Bool=true,
 )
-    ftype, argtypes = _make_evaluate_args_and_kwargs(model, varinfo, context)
+    ftype, argtypes = gen_evaluator_call_with_types(model, varinfo, context)
     return only(InteractiveUtils.code_typed(ftype, argtypes; optimize=optimize))
 end