From 719cea959346ec434208ebc45fb4c2e56433666b Mon Sep 17 00:00:00 2001 From: saadmk11 Date: Thu, 9 May 2019 17:42:01 +0600 Subject: [PATCH] Warning about using sqlite 3.26.0 for development --- docs/install.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/install.rst b/docs/install.rst index 9a76ec7967d..f02d81a2579 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -17,9 +17,9 @@ since it will help you to avoid clutter in your system-wide libraries. .. warning:: - Currently the recommended version of python is Python 3.6.7. Which uses a - lower version of sqlite3. The next version of Python can be used when the - project starts using the latest Django version. + Currently Read the Docs is using ``Django 1.11.x`` and this version of Django + has a `bug`_ which breaks database migrations if you are using ``sqlite 3.26.0 or Newer``. + So, we recommend using ``sqlite < 3.26.0`` to run Read the Docs properly on your machine. Additionally Read the Docs depends on: @@ -67,7 +67,7 @@ you need these libraries. .. tab:: CentOS/RHEL 7 Install:: - + sudo yum install python-devel python-pip libxml2-devel libxslt-devel .. tab:: Other OS @@ -84,6 +84,7 @@ you need these libraries. .. _Homebrew: http://brew.sh/ .. _Elasticsearch: https://www.elastic.co/products/elasticsearch .. _Redis: https://redis.io/ +.. _bug: https://code.djangoproject.com/ticket/29182 Get and run Read the Docs