diff --git a/packages/website/docs/DocSearch-program.md b/packages/website/docs/DocSearch-program.md index 3017ddc6..2b154df1 100644 --- a/packages/website/docs/DocSearch-program.md +++ b/packages/website/docs/DocSearch-program.md @@ -63,6 +63,21 @@ Algolia apps come with a default search API key, which also allow you to list in When your application is deployed, we provide a search **ONLY** API key, scoped to your production index, so you don't have to worry disclosing it in the frontend. +## Can I have multiple projects under the same Algolia application? + +We recommend having a single Algolia application per project. Please [apply](/apply) if you'd like to use DocSearch in an other project of yours. + +### Why ? + +The information of the initially applied project is used everywhere when we deploy your app: + +- The scope of your API keys +- The name of your Algolia application/Crawler +- The indices we generate +- The allowed domains of your Crawler + +This allow us to easily scope issues when reaching out for support. + [1]: mailto:docsearch@algolia.com [2]: https://www.algolia.com/ [3]: /docs/legacy/run-your-own diff --git a/packages/website/docs/crawler.mdx b/packages/website/docs/crawler.mdx index 827b451a..fd75ba9b 100644 --- a/packages/website/docs/crawler.mdx +++ b/packages/website/docs/crawler.mdx @@ -30,11 +30,9 @@ Ultimately, it is possible to set set the [`exclusionPatterns`](https://www.algo We've deprecated our legacy infrastructure, but you can still use it to [run your own instance](/docs/legacy/run-your-own) and plug it to [DocSearch v3](/docs/DocSearch-v3)! -## Migration seems to have started, but I don't have received any emails +## How to migrate -All of the indices from the [Legacy infrastructure](/docs/legacy/required-configuration) have been migrated, please search for emails from `docsearch@algolia.com`. If you were not part of the previous `index` owners, or the maintainer has changed, you can request access via [our support page](https://www.algolia.com/support/). - -## What do I need to do to migrate? +> Every owners should have received a migration email from `docsearch@algolia.com` with the details. If you were not part of the previous `index` owners, or the maintainer has changed, you can request access via [our support page](https://www.algolia.com/support/). All the steps are detailed in the email you've received, but in order to use the new infrastructure you need to: @@ -86,6 +84,20 @@ You should use [the dedicated web interface][2] to make any changes to your inde We did not remove access to the legacy DocSearch application (`BH4D9OD16A`) to give you the time to get familiar with our new infrastructure. `BH4D9OD16A` will remain available until the migration has been completed for all the DocSearch users. +## Search yield no results + +If your search does not yield any results, but there is no error in [your browser developer tools](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_are_browser_developer_tools), there might be an issue with your index. + +Make sure that: + +1. [Your Crawler config](/docs/record-extractor) matches your website structure + +We provide [config templates](/docs/templates) for many website generators, but you can also use them as a base. To debug your selectors, we recommend using [the URL tester](/docs/manage-your-crawls/#url-tester). + +2. Your index settings are up to date (you'll see a banner in [the search preview](/docs/manage-your-crawls/#search-preview) if not) + +The Crawler only applies `index settings` at index creation index, to keep the Algolia dashboard as the source of truth. If you have drastically changed your config, or moved to a website generator, we recommend your to delete your index from the Algolia dashboard before starting a new crawl. + ## Links related to the migration - [Docusaurus blog post](https://docusaurus.io/blog/2021/11/21/algolia-docsearch-migration) diff --git a/packages/website/docs/manage-your-crawls.mdx b/packages/website/docs/manage-your-crawls.mdx index f0698b33..94d94f06 100644 --- a/packages/website/docs/manage-your-crawls.mdx +++ b/packages/website/docs/manage-your-crawls.mdx @@ -49,3 +49,14 @@ From the [`editor`](#update-your-config), you have access to a `Search preview` alt="Algolia Crawler creation page" /> + +## URL tester + +From the [`editor`](#update-your-config), your can use the URL tester to [debug selectors](https://www.algolia.com/doc/tools/crawler/getting-started/crawler-configuration/#debugging-selectors) or how we crawl your website. + +
+