This patchset moves most of the documentation for
shipyard from markdown to reStructuredText.
README.md remains as it is nice for Github consumption
and serves as a gateway to the rest of the generated
documentation.
Change-Id: I8cec38fe0e30e9a545cb6e79ae6de1934f7dfc4e