resolves yarddoc undefined refs
Merge pull request #413 from calabash/feature/resolve-yard-doc-references

resolves yarddoc undefined refs and touches up default values for optional args