Documenter.jl update to 1.4.0 (#578)

* documenter.jl update and minor changes to make it build

* Delete docs/Manifest.toml

* ignore manifest

* add missing doc

docs/.gitignore

@@ -1,2 +1,3 @@
 build/
 site/
+Manifest.toml

docs/Project.toml

@@ -1,5 +1,3 @@
 [deps]
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
-
-[compat]
-Documenter = "0.27"
+NNlib = "872c559c-99b0-510c-b3b7-b6c96a88d5cd"

docs/make.jl

@@ -12,6 +12,7 @@ makedocs(modules = [NNlib],
             #   analytics = "UA-36890222-9",
               assets = ["assets/flux.css"],
               prettyurls = get(ENV, "CI", nothing) == "true"),
+              warnonly=[:missing_docs,]
         )
 
 deploydocs(repo = "github.com/FluxML/NNlib.jl.git",

src/upsample.jl

@@ -173,6 +173,16 @@ function upsample_nearest(x::AbstractArray{T,N}, scales::NTuple{S, <:Integer}) w
     out
 end
 
+"""
+    ∇upsample_nearest(Δ::AbstractArray{T,3}, scales::NTuple{S, <:Integer}) where T
+
+# Arguments
+- `Δ`: Incoming gradient array, backpropagated from downstream layers
+- `scales`: scales by which the image was upsampled in the first place
+
+# Outputs
+- `dx`: Downsampled version of `Δ`
+"""
 function ∇upsample_nearest(x::AbstractArray{T,N}, scales::NTuple{S, <:Integer}) where {T,N,S}
     outsize = ntuple(N) do d
         d > S && return size(x,d)