Improved panels documentation

docs/components/index.rst

@@ -101,9 +101,58 @@ This renders the following html code::
         </div>
     </div>
 
-Panel with footer
+Panel with heading
 ******************
 
+Add a nested ``panel-heading``::
+
+    {% panel %}
+        {% panelheading %}
+            Your panel heading
+        {% endpanelheading %}
+        {% panelbody %}
+            Lorem ipsum.
+        {% endpanelbody %}
+    {% endpanel %}
+
+This renders the following html code::
+
+    <div class="panel panel-default">
+        <div class="panel-heading">
+            Your panel heading
+        </div>
+        <div class="panel-body">
+            Lorem ipsum.
+        </div>
+    </div>
+
+In addition you may specify a ``panel-title`` within ``panel-heading`` using ``h1`` to ``h6``::
+
+    {% panel %}
+        {% panelheading %}
+            {% paneltitle use_tag="h1" %}
+                Your panel heading
+            {% panelheading %}
+        {% endpanelheading %}
+        {% panelbody %}
+            Lorem ipsum.
+        {% endpanelbody %}
+    {% endpanel %}
+
+This renders the following html code::
+
+    <div class="panel panel-default">
+        <div class="panel-heading">
+            Your panel heading
+        </div>
+        <div class="panel-body">
+            Lorem ipsum.
+        </div>
+    </div>
+
+Panel with footer
+*****************
+
 Add a nested ``panel-footer``::
 
     {% panel %}

setup.py

@@ -9,7 +9,7 @@
 
 setup(
     name='django-bootstrap-ui',
-    version='0.1.0-alpha.3',
+    version='0.1.0a5',
     packages=find_packages(exclude=['tests', 'docs']),
     include_package_data=True,
     license='ISC License (ISCL)',