Style rules for type annotation?

[Mason]

@Landrum

If the type of the argument is going to be given in the docstring anyways, why not just do f(x::Number) = x^2 (with appropriate docstring) instead of something like

Just to give a counter-point, it’s often useful to just not restrict method signatures unless you actually have a reason to. The docstring is telling you it expects to get numbers, but maybe you can stick a square matrix in there and it’ll be okay, or even a string:

julia> f(rand(2,2))
2×2 Array{Float64,2}:
 0.754887  0.527028
 0.932377  0.654844

julia> f("hi")
"hihi"