doc: general improvements to repl.md copy

The repl documentation has always been rather lacking. This is
a first step towards making significant improvements.

PR-URL: #7002
Reviewed-By: Anna Henningsen <[email protected]>

Author: jasnell