Searchable attributes

[dichotommy]

Attempt to improve the documentation around searchable attributes as requested in #580 .

"Attribute Importance" renamed to "Attribute Ranking Order". Information removed from API References and Main Concepts and consolidated in /guides/advanced_guides/field_properties.md.

I'm still unclear on the meaning of the last paragraph of #580 . Does this mean that if you manually reorder your searchableAttributes list, then reset it, the reset list will maintain the order you set, adding in all other attributes (new or previously non-searchable) to the end of the list?

If so, then wouldn't "reset" be a misnomer? It would actually be keeping your order while restoring the behavior of automatically adding all attributes.

[bidoubiwa]

I'm still unclear on the meaning of the last paragraph of #580 . Does this mean that if you manually reorder your searchableAttributes list, then reset it, the reset list will maintain the order you set, adding in all other attributes (new or previously non-searchable) to the end of the list?

If so, then wouldn't "reset" be a misnomer? It would actually be keeping your order while restoring the behavior of automatically adding all attributes.

Absolutely. This is something we are thinking on how we might improve it. The first step is to improve the documentation around it to receive feedback from users. After which, we can think (or not) about a rework.

It could also be interesting to initiate conversations with users on slack in order to know if they realize this setting also orders the attributes by importance (@fharper).

[bidoubiwa]

Awesome awesome job! This is made way more clear :)

[bidoubiwa]

Great great rewrite!! 🚀🔥

[bidoubiwa]

REALLY USEFUL GUIDE! Thanks so much. This is a key guide we absolutely needed 🔥🔥🔥🔥

[dichotommy]

Fixes #580