wip: docs: add a guide for running on a devstack

Private-ref: https://tasks.opencraft.com/browse/BB-9980

Author: samuelallan72

README.rst

@@ -20,6 +20,47 @@ If you have an already running platform, initialize this plugin with a command l
 
 Or use ``tutor [local|dev|k8s] launch -I`` to re-launch the platform (takes much longer).
 
+Tutor devstack setup guide
+--------------------------
+
+This is a temporary guide to use this with the experimental Typesense search backends developed for Open edX.
+The backends are found at the following pull requests:
+
+- Forum search: https://github.com/openedx/forum/pull/225
+- Course content and course overview search: https://github.com/openedx/edx-search/pull/222
+
+To begin, install `Tutor Main <https://docs.tutor.edly.io/tutorials/main.html#main>`_, prepare a directory for the new devstack, and cd to it.
+Then you can follow these steps:
+
+.. code-block:: bash
+
+    # Enable the Typesense Tutor plugin
+    git clone https://github.com/open-craft/tutor-contrib-typesense
+    pip install -e ./tutor-contrib-typesense
+    tutor plugins enable typesense
+
+    # Enable the forum and mount the custom branch of forum
+    tutor plugins enable forum
+    git clone https://github.com/open-craft/forum.git
+    git -C ./forum checkout samuel/typesense-backend
+    tutor mounts add ./forum
+
+    # Mount the custom branch of edx-search
+    git clone https://github.com/open-craft/edx-search.git
+    git -C ./edx-search checkout typesense
+    tutor mounts add ./edx-search
+
+    # Launch the devstack
+    tutor images build openedx-dev
+    tutor dev launch
+
+    # Initialise the courseware indexes (forum is initialised automatically)
+    tutor dev exec lms ./manage.py lms shell -c "import search.typesense; search.typesense.delete_indexes(); search.typesense.create_indexes()"
+
+    # Continue with normal set up - eg. create a user, import a course
+    tutor dev do createuser --staff --superuser admin admin@example.com --password password
+    tutor dev do importdemocourse
+
 Configuration
 -------------
 
@@ -34,7 +75,7 @@ These values can be modified with ``tutor config save --set PARAM_NAME=VALUE`` c
 Limitations
 -----------
 
-It's not recommended to run high availability (clustered) Typesense on Kubernetes. See `typesense/typesense#465 <https://github.com/typesense/typesense/issues/465>` and `typesense/typesense#2049 <https://github.com/typesense/typesense/issues/2049>` for more information.
+It's not recommended to run high availability (clustered) Typesense on Kubernetes. See `typesense/typesense#465 <https://github.com/typesense/typesense/issues/465>`_ and `typesense/typesense#2049 <https://github.com/typesense/typesense/issues/2049>`_ for more information.
 
 This plugin does not support deploying a clustered Typesense server.
 
@@ -61,12 +102,12 @@ Development
 
 Set up a python virtual environment, then you can install dependencies and run the tests like:
 
-  make install
-  make test
+    make install
+    make test
 
 After making some changes, you can run the auto formatter over the code for consistency:
 
-  make format
+    make format
 
 
 Open edX integration