re-instate docs for LearnTestAPI

Author: ablaom

docs/src/testing_an_implementation.md

@@ -2,56 +2,56 @@
 
 Testing is provided by the LearnTestAPI.jl package.
 
-<!-- Testing is provided by the LearnTestAPI.jl package documented below. -->
+Testing is provided by the LearnTestAPI.jl package documented below.
 
-<!-- ## Quick start -->
+## Quick start
 
-<!-- ```@docs -->
-<!-- LearnTestAPI -->
-<!-- ``` -->
+```@docs
+LearnTestAPI
+```
 
-<!-- !!! warning -->
+!!! warning
 
-<!-- 	New releases of LearnTestAPI.jl may add tests to `@testapi`, and -->
-<!-- 	this may result in new failures in client package test suites, because -->
-<!-- 	of previously undetected broken contracts. Adding a test to `@testapi` -->
-<!-- 	is not considered a breaking change -->
-<!-- 	to LearnTestAPI, unless it supports a breaking change to LearnAPI.jl. -->
+	New releases of LearnTestAPI.jl may add tests to `@testapi`, and
+	this may result in new failures in client package test suites, because
+	of previously undetected broken contracts. Adding a test to `@testapi`
+	is not considered a breaking change
+	to LearnTestAPI, unless it supports a breaking change to LearnAPI.jl.
 
 
-<!-- ## The @testapi macro -->
+## The @testapi macro
 
-<!-- ```@docs -->
-<!-- LearnTestAPI.@testapi -->
-<!-- ``` -->
+```@docs
+LearnTestAPI.@testapi
+```
 
-<!-- ## Learners for testing -->
+## Learners for testing
 
-<!-- LearnTestAPI.jl provides some simple, tested, LearnAPI.jl implementations, which may be -->
-<!-- useful for testing learner wrappers and meta-algorithms. -->
+LearnTestAPI.jl provides some simple, tested, LearnAPI.jl implementations, which may be
+useful for testing learner wrappers and meta-algorithms.
 
-<!-- ```@docs -->
-<!-- LearnTestAPI.Ridge -->
-<!-- LearnTestAPI.BabyRidge -->
-<!-- LearnTestAPI.ConstantClassifier -->
-<!-- LearnTestAPI.TruncatedSVD -->
-<!-- LearnTestAPI.Selector -->
-<!-- LearnTestAPI.FancySelector -->
-<!-- LearnTestAPI.NormalEstimator -->
-<!-- LearnTestAPI.Ensemble -->
-<!-- LearnTestAPI.StumpRegressor -->
-<!-- ``` -->
+```@docs
+LearnTestAPI.Ridge
+LearnTestAPI.BabyRidge
+LearnTestAPI.ConstantClassifier
+LearnTestAPI.TruncatedSVD
+LearnTestAPI.Selector
+LearnTestAPI.FancySelector
+LearnTestAPI.NormalEstimator
+LearnTestAPI.Ensemble
+LearnTestAPI.StumpRegressor
+```
 
-<!-- ## Private methods -->
+## Private methods
 
-<!-- For LearnTestAPI.jl developers only, and subject to breaking changes at any time: -->
+For LearnTestAPI.jl developers only, and subject to breaking changes at any time:
 
-<!-- ```@docs -->
-<!-- LearnTestAPI.@logged_testset -->
-<!-- LearnTestAPI.@nearly -->
-<!-- LearnTestAPI.isnear -->
-<!-- LearnTestAPI.learner_get -->
-<!-- LearnTestAPI.model_get -->
-<!-- LearnTestAPI.verb -->
-<!-- LearnTestAPI.filter_out_verbosity -->
-<!-- ``` -->
+```@docs
+LearnTestAPI.@logged_testset
+LearnTestAPI.@nearly
+LearnTestAPI.isnear
+LearnTestAPI.learner_get
+LearnTestAPI.model_get
+LearnTestAPI.verb
+LearnTestAPI.filter_out_verbosity
+```