Updated documentation

docs/src/api.md

@@ -45,6 +45,7 @@ mchist
 window
 details
 neid
+derivative
 ```
 
 ## Error propagation in iterative algorithms

docs/src/tutorial.md

@@ -213,6 +213,12 @@ All observables are stored in a single `BDIO` record of type `BDIO_BIN_GENERIC`.
   - Then a `Vector{String}` that contains the replica names. 
   - Finally a `Vector{Int32}` that contains the the configuration index where each measurement has been performed. 
 
+It is encouraged that the first record of the `BDIO` file is an
+`ASCII` human readable record explaining the estructure of the file. By
+convention, this record has `user info=1`. An example file containing
+the 
+
+
 !!! alert
     Obviously this weird format is what it is for some legacy reasons, but it is strongly encouraged that new implementations respect this standard with all its weirdness. 
 

src/ADerrorsTools.jl

@@ -17,12 +17,12 @@ Determines the derivate of the observable `a` with respect to observable `b` (i.
 using ADerrors # hide
 
 # Put some data 
-a = uwreal(randn(2000), "Ensemble test A", ["R0", "Rep 1", "Last rep"], [1000, 550, 450])
-b = uwreal(randn(2034), "Ensemble test B", ["R0XX", "XRep 1", "YLast rep"], [1000, 584, 450])
+a = uwreal(1.2 .+ randn(2000), "Ensemble test A", ["R0", "Rep 1", "Last rep"], [1000, 550, 450])
+b = uwreal(0.8 .+ randn(2034), "Ensemble test B", [1000, 584, 450])
 
 d = sin(a+b)
-println("Derivative of d w.r.t a:   ", derivative(d, a))
-println("Derivative of d w.r.t a^2: ", derivative(d, a^2))
+println("Derivative of d w.r.t a:      ", derivative(d, a))
+println("Derivative of d w.r.t log(a): ", derivative(d, log(a)))
 ```
 """
 function derivative(a::uwreal, p::uwreal)