documentation updates

Project.toml

@@ -12,6 +12,7 @@ PrecompileTools = "aea7be01-6a6a-4083-8856-8a6e6704d82a"
 ProgressMeter = "92933f4c-e287-5a05-a399-4b506db050ca"
 Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
 RecursiveArrayTools = "731186ca-8d62-57ce-b412-fbd966d074cd"
+Serialization = "9e88b42a-f829-5b0c-bbe9-9e923198166b"
 TensorOperations = "6aa20fa7-93e2-5fca-9bc0-fbd0db3c71a2"
 
 [compat]

README.md

@@ -68,12 +68,17 @@ CPDResult{Float64}
   Rel. error:   0.4359141301703327
 ```
 
-Now, `res` contains a CP approximation of the 3-way tensor `A`,
+Now, `res` contains a rank-$R$ CP approximation of a $d$-way tensor,
 
 ```math
-\hat A = \sum_{i=1}^r \lambda_i\, a_i \otimes b_i \otimes c_i
+\hat{\mathcal A}
+= \sum_{r=1}^{R} \lambda_r
+  u_r^{(1)} \otimes u_r^{(2)} \otimes \cdots \otimes u_r^{(d)}.
 ```
-It approximates `A` with relative error about `0.436`.
+
+For the 3-way example above, the three factor vectors of component $r$ are
+column `r` of the three factor matrices. The result approximates `A`
+with relative error about `0.436`.
 
 We access the decomposition as follows.
 ```julia

docs/Project.toml

@@ -4,3 +4,6 @@ TensorKitchen = "3630a16b-0f2f-4d88-afbf-c7d59eccf553"
 
 [sources]
 TensorKitchen = {path = ".."}
+
+[compat]
+Documenter = "1"