Add PyPI badge

Author: chrisjsewell

README.md

@@ -1,7 +1,12 @@
 # sphinx-rust
 
+[![PyPI][pypi-badge]][pypi-link]
+
 Sphinx plugin for documentation of Rust projects.
 
 **UNDER DEVELOPMENT!**
 
 See [docs/](docs/) for more information.
+
+[pypi-badge]: https://img.shields.io/pypi/v/sphinx-rust.svg
+[pypi-link]: https://pypi.org/project/sphinx-rust

docs/index.rst

@@ -1,15 +1,15 @@
 Sphinx Rust
 ===========
 
-Auto-document Rust code with :external:doc:`Sphinx <index>`!
+Auto-document `Rust <https://www.rust-lang.org/>`__ code with :external:doc:`Sphinx <index>`!
 
 .. warning::
 
     This project is in early development and is not yet ready for production use.
 
     It currently documents a subset of Rust code, and is not yet feature-complete, but this documents should give you a sense of what the final product will look like.
 
-This package is intended to bring API documentation for rust crates to Sphinx:
+This package is intended to bring API documentation for Rust crates to Sphinx:
 
 - Auto-analysis of Rust crates, with minimal steps required to get started
 
@@ -24,6 +24,9 @@ This package is intended to bring API documentation for rust crates to Sphinx:
 Installation
 ------------
 
+.. image:: https://img.shields.io/pypi/v/sphinx-rust
+    :target: https://pypi.org/project/sphinx-rust/
+
 .. code-block:: bash
 
     pip install sphinx-rust

docs/integrations/needs.rst

@@ -22,16 +22,24 @@ We can then create requirements and test cases from Rust code:
 
 .. code-block:: restructuredtext
 
+    .. rubric:: Need-list example
+
     .. needlist::
         :tags: rust
 
+    .. rubric:: Need-table example
+
     .. needtable::
         :tags: rust
         :style: table
 
+.. rubric:: Need-list example
+
 .. needlist::
   :tags: rust
 
+.. rubric:: Need-table example
+
 .. needtable::
     :tags: rust
     :style: table