Brainstorming.

README.rst

@@ -4,10 +4,12 @@
 About
 =====
 
-Google protocol buffers tools in Python 3.
+Google Protocol Buffers tools in Python 3.
 
 - `C` source code generator.
 
+- Only supports proto3.
+
 Project homepage: https://github.com/eerimoq/pbtools
 
 Documentation: http://pbtools.readthedocs.org/en/latest
@@ -36,8 +38,15 @@ proto-file.
    $ pbtools generate_c_source examples/address_book/address_book.proto
    Successfully generated address_book.h and address_book.c.
 
+See `address_book.h`_ and `address_book.c`_ for the contents of the
+generated files.
+
 .. |buildstatus| image:: https://travis-ci.org/eerimoq/pbtools.svg?branch=master
 .. _buildstatus: https://travis-ci.org/eerimoq/pbtools
 
 .. |coverage| image:: https://coveralls.io/repos/github/eerimoq/pbtools/badge.svg?branch=master
 .. _coverage: https://coveralls.io/github/eerimoq/pbtools
+
+.. _address_book.h: https://github.com/eerimoq/pbtools/blob/master/examples/address_book/generated/address_book.h
+
+.. _address_book.c: https://github.com/eerimoq/pbtools/blob/master/examples/address_book/generated/address_book.c

examples/address_book/README.rst

@@ -0,0 +1,21 @@
+ToDo: Decode fields in any order.
+
+.. code-block:: text
+
+   0a49 # person
+     0a0a # name(1)
+     4b616c6c65204b756c61
+     10 # id(2)
+     38
+     1a15 # email(3)
+     6b616c6c652e6b756c6140666f6f6261722e636f6d
+     2210 # phones #1 (4)
+       0a0c # number(1)
+       2b3436373031323332333435
+       10 # type(2)
+       01
+     2210 # phones #2 (4)
+       0a0c # number(1)
+       2b3436393939393939393939
+       10 # type(2)
+       02