[fr] Follow #1120

first stab at schema docs
[fr] Follow #1123

Path name mistakes in doc