Make some updates to search indexing documentation.
Review Request #9348 — Created Nov. 6, 2017 and submitted
This change updates our docs for search indexing to talk about
Elasticsearch and on-the-fly indexing.
- Built HTML, checked output.
This should mention that the directory and file must be writable by the web server.
Worth also recommending putting this under the
data/directory, which satisfies those requirements.
We have a hard requirement on Elasticsearch < 5.0. This is a limitation in Django-Haystack due to some non-trivial breakages in Elasticsearch 5. I'm on a thread for this, and no sufficient progress has been made yet, unfortunately...
Anyway, this will be crucial to spell out in the docs, or it'll bite people.
This will most likely need to be done as the web server user, specifically, in order to avoid permission issues.