re-order features, target, weights in docs

Author: ablaom

docs/make.jl

@@ -20,7 +20,7 @@ makedocs(
             "predict/transform" => "predict_transform.md",
             "Kinds of Target Proxy" => "kinds_of_target_proxy.md",
             "obs and Data Interfaces" => "obs.md",
-            "target/weights/features" => "target_weights_features.md",
+            "features/target/weights" => "features_target_weights.md",
             "Accessor Functions" => "accessor_functions.md",
             "Learner Traits" => "traits.md",
         ],

docs/src/target_weights_features.md renamed to docs/src/features_target_weights.md

@@ -1,13 +1,13 @@
-# [`target`, `weights`, and `features`](@id input)
+# [`features`, `target`, and `weights`](@id input)
 
 Methods for extracting parts of training observations. Here "observations" means the
 output of [`obs(learner, data)`](@ref); if `obs` is not overloaded for `learner`, then
 "observations" is any `data` supported in calls of the form [`fit(learner, data)`](@ref)
 
 ```julia
+LearnAPI.features(learner, observations) -> <training "features", suitable input for `predict` or `transform`>
 LearnAPI.target(learner, observations) -> <target variable>
 LearnAPI.weights(learner, observations) -> <per-observation weights>
-LearnAPI.features(learner, observations) -> <training "features", suitable input for `predict` or `transform`>
 ```
 
 Here `data` is something supported in a call of the form `fit(learner, data)`. 
@@ -33,15 +33,15 @@ training_loss = sum(ŷ .!= y)
 
 | method                      | fallback          | compulsory?              |
 |:----------------------------|:-----------------:|--------------------------|
+| [`LearnAPI.features`](@ref) | see docstring     | if fallback insufficient |
 | [`LearnAPI.target`](@ref)   | returns `nothing` | no                       |
 | [`LearnAPI.weights`](@ref)  | returns `nothing` | no                       |
-| [`LearnAPI.features`](@ref) | see docstring     | if fallback insufficient |
 
 
 # Reference
 
 ```@docs
+LearnAPI.features
 LearnAPI.target
 LearnAPI.weights
-LearnAPI.features
 ```

docs/src/reference.md

@@ -183,8 +183,8 @@ Most learners will also implement [`predict`](@ref) and/or [`transform`](@ref).
   implement the observation access API specified by
   [`LearnAPI.data_interface(learner)`](@ref).
 
-- [`LearnAPI.target`](@ref input), [`LearnAPI.weights`](@ref input),
-  [`LearnAPI.features`](@ref): for extracting relevant parts of training data, where
+- [`LearnAPI.features`](@ref input), [`LearnAPI.target`](@ref input),
+  [`LearnAPI.weights`](@ref input): for extracting relevant parts of training data, where
   defined.
 
 - [Accessor functions](@ref accessor_functions): these include functions like