docs(README): Update docs

Author: tony

README.md

@@ -1,7 +1,7 @@
 # `libvcs` · [![Python Package](https://img.shields.io/pypi/v/libvcs.svg)](https://pypi.org/project/libvcs/) [![License](https://img.shields.io/github/license/vcs-python/libvcs.svg)](https://github.com/vcs-python/libvcs/blob/master/LICENSE) [![Code Coverage](https://codecov.io/gh/vcs-python/libvcs/branch/master/graph/badge.svg)](https://codecov.io/gh/vcs-python/libvcs)
 
-libvcs is an abstraction layer for vcs systems. powers
-[vcspull](https://www.github.com/vcs-python/vcspull/).
+libvcs is a lite, [typed](https://docs.python.org/3/library/typing.html), pythonic wrapper for
+`git`, `hg`, and `svn`. Powers [vcspull](https://www.github.com/vcs-python/vcspull/).
 
 ## Setup
 
@@ -39,8 +39,11 @@ to inspect / checkout / update:
 ...     vcs='git',
 ...     dir='/tmp/libtmux'
 ... )
+```
+
+Initialize via "pip-style URLs":
 
-# or via pip-style URL
+```python
 >>> r = create_repo_from_pip_url(
 ...     pip_url='git+https://www.github.com/vcs-python/libtmux',
 ...     dir='/tmp/libtmux'
@@ -50,7 +53,6 @@ to inspect / checkout / update:
 Update / clone repo:
 
 ```python
-# it may or may not be checked out/cloned on the system yet
 >>> r.update_repo()
 ```