fix table of contents for the docs

Author: ablaom

docs/Project.toml

@@ -1,5 +1,6 @@
 [deps]
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+LearnAPI = "92ad9a40-7767-427a-9ee6-6e577f1266cb"
 MLUtils = "f1d291b0-491e-4a28-83b9-f70985020b54"
 ScientificTypesBase = "30f210dd-8aff-4c5f-94ba-8e64358c1161"
 Tables = "bd369af6-aec1-5ad0-b16a-f7cc5008161c"

docs/make.jl

@@ -10,14 +10,16 @@ makedocs(
     pages=[
         "Home" => "index.md",
         "Anatomy of an Implementation" => "anatomy_of_an_implementation.md",
-        "Reference" => "reference.md",
-        "... fit" => "fit.md",
-        "... predict/transform" => "predict_transform.md",
-        "... Kinds of Target Proxy" => "kinds_of_target_proxy.md",
-        "... minimize" => "minimize.md",
-        "... obs" => "obs.md",
-        "... Accessor Functions" => "accessor_functions.md",
-        "... Algorithm Traits" => "traits.md",
+        "Reference" => [
+            "Summary" => "reference.md",
+            "fit" => "fit.md",
+            "predict/transform" => "predict_transform.md",
+            "Kinds of Target Proxy" => "kinds_of_target_proxy.md",
+            "minimize" => "minimize.md",
+            "obs" => "obs.md",
+            "Accessor Functions" => "accessor_functions.md",
+            "Algorithm Traits" => "traits.md",
+        ],
         "Common Implementation Patterns" => "common_implementation_patterns.md",
         "Testing an Implementation" => "testing_an_implementation.md",
     ],

docs/src/anatomy_of_an_implementation.md

@@ -215,7 +215,7 @@ functionality provided by third party packages, and to assist third party algori
 match machine learning algorithms to user-defined tasks.
 
 According to the contract articulated in its document string, having set
-[`LearnAPI.target(::Ridge)`](@ref) equal to `true`, we are obliged to overload a
+[`LearnAPI.target`](@ref)`(::Ridge)`](@ref) equal to `true`, we are obliged to overload a
 multi-argument version of `LearnAPI.target` to extract the target from the `data` that
 gets supplied to `fit`: