Move some docstrings to internals page (#89)

Author: mortenpi

docs/make.jl

@@ -13,6 +13,7 @@ makedocs(
     pages = Any[
         "Home" => "index.md",
         "Showcase" => "showcase.md",
+        "Internals" => "internals.md",
     ],
     format = Documenter.HTML(
         assets = ["assets/favicon.ico"],

docs/src/index.md

@@ -7,13 +7,16 @@ DocStringExtensions
 ## Index
 
 ```@index
-Modules = [DocStringExtensions]
+Pages = ["index.md"]
 ```
 
 ## Reference
 
 ```@autodocs
 Modules = [DocStringExtensions]
-Order = [:constant, :function, :macro, :type]
+Order = [:constant]
 ```
 
+```@docs
+DocStringExtensions.@template
+```

docs/src/internals.md

@@ -0,0 +1,12 @@
+# Internals
+
+These functions, types etc. are internal to DocStringExtensions and **not part of the public API**. They may change or be removed arbitrarily from version to version.
+
+```@index
+Pages = ["internals.md"]
+```
+
+```@autodocs
+Modules = [DocStringExtensions]
+Order = [:function, :type]
+```