add completions for source and document the move away from '.'

Closes: #310