DOC improve narrative documentation