Merge pull request #419 from jnns/master

Improve documentation.

README.rst

@@ -4,10 +4,19 @@ django-import-export
 
 .. image:: https://travis-ci.org/django-import-export/django-import-export.svg?branch=master
     :target: https://travis-ci.org/django-import-export/django-import-export
+    :alt: Build status on Travis-CI
+
 .. image:: https://img.shields.io/pypi/v/django-import-export.svg
     :target: https://pypi.python.org/pypi/django-import-export
+    :alt: Current version on PyPi
+
 .. image:: https://img.shields.io/pypi/dm/django-import-export.svg
-        :target: https://pypi.python.org/pypi/django-import-export    
+    :target: https://pypi.python.org/pypi/django-import-export
+    :alt: Downloads per month on PyPi
+
+.. image:: http://readthedocs.org/projects/django-import-export/badge/?version=latest
+    :target: http://django-import-export.rtfd.org
+    :alt: Docmentation
 
 django-import-export is a Django application and library for importing
 and exporting data with included admin integration.
@@ -25,7 +34,7 @@ Features:
 
 * export data respecting admin filters
 
-.. image:: https://raw.github.com/django-import-export/django-import-export/master/docs/_static/images/django-import-export-change.png
+.. image:: docs/_static/images/django-import-export-change.png
 
 
 * Documentation: https://django-import-export.readthedocs.org/en/latest/
@@ -56,6 +65,10 @@ If you'd like to contribute, simply fork `the repository`_, commit your
 changes to the **develop** branch (or branch off of it), and send a pull
 request. Make sure you add yourself to AUTHORS_.
 
+As most projects, we try to follow PEP8_ as closely as possible. Please bear
+in mind that most pull requests will be rejected without proper unit testing.
+
+.. _`PEP8`: https://www.python.org/dev/peps/pep-0008/
 .. _`tablib`: https://github.com/kennethreitz/tablib
 .. _`the repository`: https://github.com/django-import-export/django-import-export/
 .. _AUTHORS: https://github.com/django-import-export/django-import-export/blob/master/AUTHORS

docs/api_admin.rst

@@ -2,5 +2,7 @@
 Admin
 =====
 
+For instructions on how to use the models and mixins in this module, please refer to :ref:`admin-integration`.
+
 .. automodule:: import_export.admin
    :members:

docs/api_tmp_storages.rst

@@ -1,6 +1,6 @@
-============
-Tmp storages
-============
+==================
+Temporary storages
+==================
 
 .. currentmodule:: import_export.tmp_storages
 

docs/api_widgets.rst

@@ -23,6 +23,9 @@ Widgets
 .. autoclass:: import_export.widgets.TimeWidget
   :members:
 
+.. autoclass:: import_export.widgets.DateTimeWidget
+   :members:
+
 .. autoclass:: import_export.widgets.ForeignKeyWidget
    :members:
 

docs/changelog.rst

@@ -1,5 +1,5 @@
-Changelog for django-import-export
-==================================
+Changelog
+=========
 
 0.4.3 (unreleased)
 ------------------
@@ -12,6 +12,7 @@ Changelog for django-import-export
 
 - Add support for django.db.models.TimeField (#381)
 
+
 0.4.2 (2015-12-18)
 ------------------
 
@@ -89,7 +90,7 @@ Changelog for django-import-export
 
 - added use of get_diff_headers method into import.html template (#158)
 
-- Try to use OrderedDict instead of SortedDict, which is deprecated in 
+- Try to use OrderedDict instead of SortedDict, which is deprecated in
   Django 1.7 (#157)
 
 - fixed #105 unicode import
@@ -112,9 +113,9 @@ Changelog for django-import-export
 
 - Fixed XLS import on python 3. Optimized loop
 
-- Fixed properly skipping row marked as skipped when importing data from 
+- Fixed properly skipping row marked as skipped when importing data from
   the admin interface.
-  
+
 - Allow Resource.export to accept iterables as well as querysets
 
 - Improve error messages

docs/conf.py

@@ -35,7 +35,7 @@
 
 # General information about the project.
 project = u'django-import-export'
-copyright = u'2012, Bojan Mihelac'
+copyright = u'2012–2016, Bojan Mihelac'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -90,6 +90,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 html_theme = 'default'
+html_theme = "sphinx_rtd_theme"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the