docs,tests(parse,base): Docs and test update

Author: tony

libvcs/parse/base.py

@@ -69,7 +69,12 @@ def register(self, cls: Matcher) -> None:
            path=org/repo,
            matcher=core-git-scp)
 
-        We need something more specific. What do we do?
+        >>> GitURL(url="github:org/repo").to_url()
+        'git@github:org/repo'
+
+        Eek. That won't work, can't do much with that one.
+
+        We need something more specific so usable URLs can be generated. What do we do?
 
         **Extending matching capability:**
 
@@ -111,8 +116,8 @@ def register(self, cls: Matcher) -> None:
         >>> GitHubURL.is_valid(url='gitlab:vcs-python/libvcs')
         False
 
-        `GitHubURL` sees this as invalid since it only has one matcher,
-        `GitHubPrefix`.
+        ``GitHubURL`` sees this as invalid since it only has one matcher,
+        ``GitHubPrefix``.
 
         >>> GitURL.is_valid(url='gitlab:vcs-python/libvcs')
         True