more on docs

Author: barseghyanartur

docs/faq.rst

@@ -1,11 +1,11 @@
 FAQ
 ===
 You will find a lot of useful information in the `documentation
-<https://django-elasticsearch-dsl-drf.readthedocs.io/>`_.
+<https://django-elasticsearch-dsl-drf.readthedocs.io/>`__.
 
 Additionally, all raised issues that were questions have been marked as
 `question`, so you could take a look at the
-`closed (question) issues <https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/issues?q=is%3Aissue+label%3Aquestion+is%3Aclosed>`_.
+`closed (question) issues <https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/issues?q=is%3Aissue+label%3Aquestion+is%3Aclosed>`__.
 
 Questions and answers
 ---------------------
@@ -21,19 +21,24 @@ Yes. There are many ways doing this in Elasticsearch.
 
 To mention a couple:
 
-- You could use partial matching using NGrams. Partially shown `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/0.17.2/advanced_usage_examples.html?highlight=ngram#id8)>`_.
-  `The basic idea <https://www.elastic.co/guide/en/elasticsearch/guide/current/_ngrams_for_partial_matching.html>`_.
-- Use `contains <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/filtering_usage_examples.html?highlight=contains#contains>`_
+- You could use partial matching using NGrams. Partially shown
+  `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/0.17.2/advanced_usage_examples.html?highlight=ngram#id8)>`__.
+  `The basic idea <https://www.elastic.co/guide/en/elasticsearch/guide/current/_ngrams_for_partial_matching.html>`__.
+- Use `contains <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/filtering_usage_examples.html?highlight=contains#contains>`__
   functional filter.
 
+----
+
 **Question**
 
 Can we use Django REST Framework ``serializers.ModelSerializer`` directly?
 
 **Answer**
 
 No, but you could use ``serializers.Serializer``. `Read the docs
-<https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html?highlight=serializer#serializer-definition>`_.
+<https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html?highlight=serializer#serializer-definition>`__.
+
+----
 
 **Question**
 
@@ -42,7 +47,7 @@ How can I order search results overall relevance
 **Answer**
 
 That's ``_score``. See the following `example
-<https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/blob/master/examples/simple/search_indexes/viewsets/book/frontend.py#L206>`_.
+<https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/blob/master/examples/simple/search_indexes/viewsets/book/frontend.py#L206>`__.
 
 .. code-block:: python
 
@@ -51,21 +56,27 @@ That's ``_score``. See the following `example
 In the given example, results are sorted by the ``score`` (which is relevance),
 then by ``id``, ``title`` and ``price``.
 
+----
+
 **Question**
 
 How can I separate my development/production/acceptance/test indexes?
 
 **Answer**
 
-It's documented `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html#settings>`_.
+It's documented `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html#settings>`__.
+
+----
 
 **Question**
 
 How can I sync my database with Elasticsearch indexes.
 
 **Answer**
 
-It's documented `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html#sample-partial-sync-using-custom-signals>`_.
+It's documented `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html#sample-partial-sync-using-custom-signals>`__.
+
+----
 
 **Question**
 
@@ -76,4 +87,4 @@ in settings.
 **Answer**
 
 Once of the possible reasons for the mentioned symptom might be `low disk space
-<https://discuss.elastic.co/t/forbidden-12-index-read-only-allow-delete-api/110282>`_.
+<https://discuss.elastic.co/t/forbidden-12-index-read-only-allow-delete-api/110282>`__.

docs_src/faq.rst

@@ -1,11 +1,11 @@
 FAQ
 ===
 You will find a lot of useful information in the `documentation
-<https://django-elasticsearch-dsl-drf.readthedocs.io/>`_.
+<https://django-elasticsearch-dsl-drf.readthedocs.io/>`__.
 
 Additionally, all raised issues that were questions have been marked as
 `question`, so you could take a look at the
-`closed (question) issues <https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/issues?q=is%3Aissue+label%3Aquestion+is%3Aclosed>`_.
+`closed (question) issues <https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/issues?q=is%3Aissue+label%3Aquestion+is%3Aclosed>`__.
 
 Questions and answers
 ---------------------
@@ -21,19 +21,24 @@ Yes. There are many ways doing this in Elasticsearch.
 
 To mention a couple:
 
-- You could use partial matching using NGrams. Partially shown `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/0.17.2/advanced_usage_examples.html?highlight=ngram#id8)>`_.
-  `The basic idea <https://www.elastic.co/guide/en/elasticsearch/guide/current/_ngrams_for_partial_matching.html>`_.
-- Use `contains <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/filtering_usage_examples.html?highlight=contains#contains>`_
+- You could use partial matching using NGrams. Partially shown
+  `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/0.17.2/advanced_usage_examples.html?highlight=ngram#id8)>`__.
+  `The basic idea <https://www.elastic.co/guide/en/elasticsearch/guide/current/_ngrams_for_partial_matching.html>`__.
+- Use `contains <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/filtering_usage_examples.html?highlight=contains#contains>`__
   functional filter.
 
+----
+
 **Question**
 
 Can we use Django REST Framework ``serializers.ModelSerializer`` directly?
 
 **Answer**
 
 No, but you could use ``serializers.Serializer``. `Read the docs
-<https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html?highlight=serializer#serializer-definition>`_.
+<https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html?highlight=serializer#serializer-definition>`__.
+
+----
 
 **Question**
 
@@ -42,7 +47,7 @@ How can I order search results overall relevance
 **Answer**
 
 That's ``_score``. See the following `example
-<https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/blob/master/examples/simple/search_indexes/viewsets/book/frontend.py#L206>`_.
+<https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/blob/master/examples/simple/search_indexes/viewsets/book/frontend.py#L206>`__.
 
 .. code-block:: python
 
@@ -51,21 +56,27 @@ That's ``_score``. See the following `example
 In the given example, results are sorted by the ``score`` (which is relevance),
 then by ``id``, ``title`` and ``price``.
 
+----
+
 **Question**
 
 How can I separate my development/production/acceptance/test indexes?
 
 **Answer**
 
-It's documented `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html#settings>`_.
+It's documented `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html#settings>`__.
+
+----
 
 **Question**
 
 How can I sync my database with Elasticsearch indexes.
 
 **Answer**
 
-It's documented `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html#sample-partial-sync-using-custom-signals>`_.
+It's documented `here <https://django-elasticsearch-dsl-drf.readthedocs.io/en/latest/quick_start.html#sample-partial-sync-using-custom-signals>`__.
+
+----
 
 **Question**
 
@@ -76,4 +87,4 @@ in settings.
 **Answer**
 
 Once of the possible reasons for the mentioned symptom might be `low disk space
-<https://discuss.elastic.co/t/forbidden-12-index-read-only-allow-delete-api/110282>`_.
+<https://discuss.elastic.co/t/forbidden-12-index-read-only-allow-delete-api/110282>`__.