Fix/add headers in method docstrings

Author: abhro

src/composition/learning_networks/signatures.jl

@@ -307,7 +307,8 @@ See also [`MLJBase.Signature`](@ref).
 """
 fitted_params_supplement(signature::Signature) = call_and_copy(fitted_params_nodes(signature))
 
-""" report(signature; supplement=true)
+"""
+    report(signature; supplement=true)
 
 **Private method.**
 

src/data/datasets_synthetic.jl

@@ -318,7 +318,12 @@ Make portion `s` of vector `θ` exactly 0.
 """
 sparsify!(rng, θ, s) = (θ .*= (rand(rng, length(θ)) .< s))
 
-"""Add outliers to portion s of vector."""
+"""
+    outlify!(rng, y, s)
+
+Add outliers to portion `s` of vector.
+
+"""
 outlify!(rng, y, s) =
         (n = length(y); y .+= 20 * randn(rng, n) .* (rand(rng, n) .< s))
 

src/machines.jl

@@ -529,7 +529,7 @@ err_missing_model(model) = ErrorException(
 )
 
 """
-   last_model(mach::Machine)
+    last_model(mach::Machine)
 
 Return the last model used to train the machine `mach`. This is a bona fide model, even if
 `mach.model` is a symbol.

src/show.jl

@@ -50,14 +50,22 @@ macro constant(ex)
     end
 end
 
-"""to display abbreviated versions of integers"""
+"""
+    abbreviated(n)
+
+Display abbreviated versions of integers.
+"""
 function abbreviated(n)
     as_string = string(n)
     return "@"*as_string[end-2:end]
 end
 
-"""return abbreviated object id (as string) or it's registered handle
-(as string) if this exists"""
+"""
+    handle(X)
+
+return abbreviated object id (as string) or it's registered handle
+(as string) if this exists
+"""
 function handle(X)
     id = objectid(X)
     if id in keys(HANDLE_GIVEN_ID)