docbrown/docs/backend/algolia.md
Jacob Herrington 7d0aeeefe5 Improve the clarity of the docs and fix Prettier config (#4899)
* Improve format and clarity of the docs [ci skip]

While this change produces a lot of git noise by enacting what seems
like an arbitrary linewrap on most of the files in the documentation it
will result in better version control and tracking of the changes in the
documentation.

For example, as it currently stands, if one was to make a
PR to move a comma in a sentence because each paragraph in most of the
files is on a single line, that small change would look in the git
history like the author had modified the entire paragraph. In reality,
this author just moved a comma.

This change also includes a significant number of modifications to the
more article-esque docs. Many of these docs were written in a sort of
stream-of-conciousness and aren't as easy to read as they could be.
Hopefully this is the first of several readability changes. If we could
get these docs to a more accessible reading level, we would probably see
an increase in contributions. :)

* Delegate markdown wrapping to Prettier

* Add linewrapping explanation in the docs [ci skip]
2019-11-26 08:40:53 -05:00

2 KiB

title
Algolia

Algolia is a third party service that powers the search. When working with the API, you will likely need to utilize Algolia. You will need to sign up for a free-tier account, retrieve the keys, and provide those keys to the Rails application.

Sign up

  1. Go to the Algolia sign up page.

  2. Choose one of the three methods of signing up: email, GitHub, or Google.

  3. Fill in your information.

    algolia-up-1

  4. Select the datacenter's region.

    algolia-up-2

  5. Fill in or skip the project information.

    algolia-up-3

  6. You are all set up now! You can go to your dashboard.

    algolia-up-4

  7. You can skip the tutorial, by clicking on API button.

    algolia-up-5

  8. All good! You can get your API keys now.

Get API keys

  1. Sign up or Sign in to your Algolia account.

  2. From your Dashboard, click on API Keys.

    algolia-1

  3. Change your keys accordingly (name of Algolia key -> name of our ENV variable):

    Application ID -> ALGOLIASEARCH_APPLICATION_ID
    Search-Only API Key -> ALGOLIASEARCH_SEARCH_ONLY_KEY
    Admin API KEY -> ALGOLIASEARCH_API_KEY
    

    algolia-2

  4. Done.