doc updates with screenshot, less gotchas and JALT reference