Make some updates to search indexing documentation.

Review Request #9348 — Created Nov. 6, 2017 and submitted

Information

Review Board
release-3.0.x
51cabc9...

Reviewers

This change updates our docs for search indexing to talk about
Elasticsearch and on-the-fly indexing.

  • Built HTML, checked output.
  • Spellcheck.
Description From Last Updated

This should mention that the directory and file must be writable by the web server. Worth also recommending putting this …

chipx86chipx86

We have a hard requirement on Elasticsearch < 5.0. This is a limitation in Django-Haystack due to some non-trivial breakages …

chipx86chipx86

This will most likely need to be done as the web server user, specifically, in order to avoid permission issues.

chipx86chipx86
chipx86
  1. 
      
  2. docs/manual/admin/sites/search-indexing.rst (Diff revision 1)
     
     
     
     
    Show all issues

    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.

  3. docs/manual/admin/sites/search-indexing.rst (Diff revision 1)
     
     
     
     
    Show all issues

    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.

  4. docs/manual/admin/sites/search-indexing.rst (Diff revision 1)
     
     
     
    Show all issues

    This will most likely need to be done as the web server user, specifically, in order to avoid permission issues.

  5. 
      
david
chipx86
  1. Ship It!
  2. 
      
david
Review request changed
Status:
Completed
Change Summary:
Pushed to release-3.0.x (7ff6796)