finish documentation for Issue 1929 UI flow