Добавлена документация

[asyncee]

Этот merge-request реализует документацию с использованием sphinx.

Что сделано:

• создана директория docs
• в неё перенесена существующая документация и разбита на разделы
• создана базовая конфигурация sphinx

Как собрать документацию::

pip install sphinx                                                          
cd django-fias/docs                                                         
make dirhtml                                                                
cd build/dirhtml                                                            
python -m http.server 8000                                                  

Проследовать по адресу http://localhost:8000/                               

В качестве примера я взял документацию к своему проекту https://github.com/asyncee/django-easy-select2 и доработал её под django-fias.

Что рекомендуется сделать автору проекта:

• сгенерировать документацию
• внимательно просмотреть
• структурировать и отредактировать по своему усмотрению
• после этого влить изменения в проект и подключить сервис read the docs
  (easy-select2 собирается через него)

Что можно внести в планы:

• документация существующего программного кода (докстринги)
• настройка тестового проекта
• конфигурация docs/conf.py для использования automodule (автогенерация
  документации по исходникам)
• подключение соответствующих секций в index.rst или в sources.rst