doc update (some visuals) and some additional references.