Update specs w/ title meta data and automated TOC

Author: zbeekman

doc/specs/index.md

@@ -0,0 +1,5 @@
+---
+title: specs
+---
+
+@todo Explain what these are, how to write them, why they're needed, etc.

doc/specs/stdlib_experimental_error.md

@@ -1,8 +1,10 @@
-# Catching and handling errors
+---
+title: experimental_error
+---
 
-* [`check` - Checks the value of a logical condition](#check---checks-the-value-of-a-logical-condition)
-* [`error_stop` - aborts the program](#error_stop---aborts-the-program)
+# Catching and handling errors
 
+[TOC]
 
 ## `check` - Checks the value of a logical condition
 

doc/specs/stdlib_experimental_io.md

@@ -1,8 +1,10 @@
+---
+title: experimental_IO
+---
+
 # IO
 
-* [`loadtxt` - load a 2D array from a text file](#loadtxt---load-a-2d-array-from-a-text-file)
-* [`open` - open a file](#open---open-a-file)
-* [`savetxt` - save a 2D array into a text file](#savetxt---save-a-2d-array-into-a-text-file)
+[TOC]
 
 ## `loadtxt` - load a 2D array from a text file
 

doc/specs/stdlib_experimental_linalg.md

@@ -1,8 +1,10 @@
+---
+title: experimental_linalg
+---
+
 # Linear Algebra
 
-* [`diag` - Create a diagonal array or extract the diagonal elements of an array](#diag---create-a-diagonal-array-or-extract-the-diagonal-elements-of-an-array)
-* [`eye` - Construct the identity matrix](#eye---construct-the-identity-matrix)
-* [`trace` - Trace of a matrix](#trace---trace-of-a-matrix)
+[TOC]
 
 ## `diag` - Create a diagonal array or extract the diagonal elements of an array
 

doc/specs/stdlib_experimental_optval.md

@@ -1,6 +1,10 @@
+---
+title: experimental_optval
+---
+
 # Default values for optional arguments
 
-* [`optval` - fallback value for optional arguments](#optval---fallback-value-for-optional-arguments)
+[TOC]
 
 ## `optval` - fallback value for optional arguments
 

doc/specs/stdlib_experimental_quadrature.md

@@ -1,9 +1,10 @@
+---
+title: experimental_quadrature
+---
+
 # Numerical integration
 
-* [`trapz` - integrate sampled values using trapezoidal rule](#trapz---integrate-sampled-values-using-trapezoidal-rule)
-* [`trapz_weights` - trapezoidal rule weights for given abscissas](#trapz_weights---trapezoidal-rule-weights-for-given-abscissas)
-* [`simps` - integrate sampled values using Simpson's rule (to be implemented)](#simps---integrate-sampled-values-using-simpsons-rule-to-be-implemented)
-* [`simps_weights` - Simpson's rule weights for given abscissas (to be implemented)](#simps_weights---simpsons-rule-weights-for-given-abscissas-to-be-implemented)
+[TOC]
 
 ## `trapz` - integrate sampled values using trapezoidal rule
 

doc/specs/stdlib_experimental_stats.md

@@ -1,10 +1,10 @@
-# Descriptive statistics
+---
+title: experimental_stats
+---
 
-* [`cov` - covariance of array elements](#cov---covariance-of-array-elements)
-* [`mean` - mean of array elements](#mean---mean-of-array-elements)
-* [`moment` - central moments of array elements](#moment---central-moments-of-array-elements)
-* [`var` - variance of array elements](#var---variance-of-array-elements)
+# Descriptive statistics
 
+[TOC]
 
 ## `cov` - covariance of array elements