fix doctests (#190)

* fix docstests

* cleanup

* related packages

.gitignore

@@ -1,7 +1,7 @@
 *.jl.*.cov
 *.jl.cov
 *.jl.mem
-/Manifest.toml
+Manifest.toml
 docs/build
 .vscode
 /test.jl

README.md

@@ -62,10 +62,20 @@ copied. In fact, while `x` and `y` are materialized arrays,
 all the rest are data views. 
 
 
-## Related Packages
+## Historical Notes
 
 *MLUtils.jl* brings together functionalities previously found in [LearnBase.jl](https://github.com/JuliaML/LearnBase.jl) , [MLDataPattern.jl](https://github.com/JuliaML/MLDataPattern.jl) and [MLLabelUtils.jl](https://github.com/JuliaML/MLLabelUtils.jl). These packages are now discontinued. 
 
 Other features were ported from the deep learning library [Flux.jl](https://github.com/FluxML/Flux.jl), as they are of general use. 
 
-[MLJ.jl](https://alan-turing-institute.github.io/MLJ.jl/dev/) is a more complete package for managing the whole machine learning pipeline if you are looking for a sklearn replacement.
+
+## Alternatives and Related Packages
+
+- [MLJ.jl](https://alan-turing-institute.github.io/MLJ.jl/dev/) is a more complete package for managing the whole machine learning pipeline if you are looking for a sklearn replacement.
+
+- [NNlib.jl](https://github.com/FluxML/NNlib.jl) provides utility functions for neural networks.
+
+- [TableTransforms.jl](https://github.com/JuliaML/TableTransforms.jl) contains transformations for tabular datasets.
+
+- [DataAugmentation.jl](https://github.com/FluxML/DataAugmentation.jl). Efficient, composable data augmentation for machine and deep learning with support for n-dimensional images, keypoints and categorical masks.
+

docs/make.jl

@@ -14,12 +14,11 @@ DocMeta.setdocmeta!(MLUtils, :DocTestSetup, :(using MLUtils); recursive=true)
 
 makedocs(;
     modules=[MLUtils],
-    doctest=true, 
-    clean=true,     
     sitename = "MLUtils.jl",
     pages = ["Home" => "index.md",
              "API" => "api.md"],
 )
 
-deploydocs(repo="github.com/JuliaML/MLUtils.jl.git", 
-          devbranch="main")
+rm(joinpath(@__DIR__, "src/index.md"))
+
+deploydocs(repo="github.com/JuliaML/MLUtils.jl.git",  devbranch="main")

docs/src/api.md

@@ -51,6 +51,8 @@ splitobs
 falses_like
 fill_like
 ones_like
+rand_like
+randn_like
 trues_like
 zeros_like
 ```
@@ -71,7 +73,6 @@ group_counts
 group_indices
 normalise
 rpad_constant
-stack
 unbatch
 unsqueeze
 unstack