Add more docs

Author: lgoettgens

docs/src/deps_compat.md

@@ -7,6 +7,8 @@ and to keep everything working in the case of breaking changes in Julia or your
 
 For more details, see the [Pkg docs](https://julialang.github.io/Pkg.jl/v1/compatibility/).
 
+## [Test function](@id test_deps_compat)
+
 ```@docs
 Aqua.test_deps_compat
 ```

docs/src/exports.md

@@ -1,5 +1,7 @@
 # Undefined exports
 
+## [Test function](@id test_undefined_exports)
+
 ```@docs
 Aqua.test_undefined_exports
 ```

docs/src/project_extras.md

@@ -9,6 +9,8 @@ There are two different ways to specify test-only dependencies (see [the Pkg doc
 This test checks checks that, in case you use both methods, the set of test-only dependencies
 is the same in both ways.
 
+## [Test function](@id test_project_extras)
+
 ```@docs
 Aqua.test_project_extras
 ```

docs/src/stale_deps.md

@@ -1,5 +1,7 @@
 # Stale dependencies
 
+## [Test function](@id test_stale_deps)
+
 ```@docs
 Aqua.test_stale_deps
 ```

docs/src/test_all.md

@@ -1,5 +1,9 @@
 # [Test everything](@id test_all)
 
+This test runs most of the other tests in this module.
+The defaults should be fine for most packages.
+If you have a package that needs to customize the test, you can do so by providing appropriate keyword arguments to `Aqua.test_all()` (see below)
+
 ```@docs
 Aqua.test_all
 ```

docs/src/unbound_args.md

@@ -27,6 +27,8 @@ h() = do_something(T[])
 h(x1::T, x2::T...) = do_something(T[x1, x2...])
 ```
 
+## [Test function](@id test_unbound_args)
+
 ```@docs
 Aqua.test_unbound_args
 ```

src/Aqua.jl

@@ -24,7 +24,7 @@ include("persistent_tasks.jl")
 """
     test_all(testtarget::Module)
 
-Run following tests in isolated testset:
+Run the following tests:
 
 * [`test_ambiguities([testtarget, Base, Core])`](@ref test_ambiguities)
 * [`test_unbound_args(testtarget)`](@ref test_unbound_args)