Split Elasticsearch docs to admin and user

doc/README.md

@@ -54,6 +54,8 @@ Shortcuts to GitLab's most visited docs:
   - [Create a group](gitlab-basics/create-group.md)
   - [GitLab Subgroups](user/group/subgroups/index.md)
 - [Search through GitLab](user/search/index.md): Search for issues, merge requests, projects, groups, todos, and issues in Issue Boards.
+  - **(EES/EEP)** [Global code search](user/search/global_code_search.md): Leverage Elasticsearch for faster, more advanced code search across your entire GitLab instance.
+  - **(EES/EEP)** [Advanced search syntax](user/search/advanced_search_syntax.md): Use advanced queries for more targeted search results.
 - [Snippets](user/snippets.md): Snippets allow you to create little bits of code.
 - [Wikis](user/project/wiki/index.md): Enhance your repository documentation with built-in wikis.
 - [GitLab Pages](user/project/pages/index.md): Build, test, and deploy your static website with GitLab Pages.
@@ -161,7 +163,8 @@ have access to GitLab administration tools and settings.
 - [User cohorts](user/admin_area/user_cohorts.md) View user activity over time.
 - [Web terminals](administration/integration/terminal.md): Provide terminal access to environments from within GitLab.
 - **(EES/EEP)** [Audit logs and events](administration/audit_events.md): View the changes made within the GitLab server.
-- **(EES/EEP)** [Elasticsearch](integration/elasticsearch.md): A flexible, scalable and powerful search service to keep GitLab's search fast when dealing with huge amount of data.
+- **(EES/EEP)** [Elasticsearch](integration/elasticsearch.md): Enable Elasticsearch,
+  a flexible, scalable and powerful search service to keep GitLab's search fast when dealing with huge amount of data.
 - **(EES/EEP)** [Email users](tools/email.md): Email GitLab users from within GitLab.
 - **(EES/EEP)** [Limit project size](user/admin_area/settings/account_and_limit_settings.md): Set a hard limit for your repositories' size.
 - **(EEP)** [Auditor users](administration/auditor_users.md): Users with read-only access to all projects, groups, and other resources on the GitLab instance.

doc/user/search/advanced_search_syntax.md

@@ -2,12 +2,23 @@
 
 >**Notes:**
 - Introduced in [GitLab Enterprise Starter][ee] 9.2
-- The [Elasticsearch integration](../../integration/elasticsearch.md) needs to
-  be enabled
+- This is the user documentation. To install and configure Elasticsearch,
+  visit the [admin docs](../../integration/elasticsearch.md).
 
-Full details can be found in the
-[Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-simple-query-string-query.html#_simple_query_string_syntax)
-but here's a quick guide:
+Use advanced queries for more targeted search results.
+
+## Overview
+
+The advanced search syntax is a subset of the [global code search](global_code_search.md)
+which you can use to have more specific search results.
+
+## Use cases
+
+
+## Using the advanced search syntax
+
+Full details can be found in the [Elasticsearch documentation][elastic], but
+here's a quick guide:
 
 * Searches look for all the words in a query, in any order - e.g.: searching
   issues for `display bug` will return all issues matching both those words, in any order.
@@ -19,3 +30,4 @@ but here's a quick guide:
 * To find a term containing one of these symbols, use `\`: `argument \-last`
 
 [ee]: https://about.gitlab.com/gitlab-ee/
+[elastic]: https://www.elastic.co/guide/en/elasticsearch/reference/5.3/query-dsl-simple-query-string-query.html#_simple_query_string_syntax

doc/user/search/global_code_search.md

+# Global code search
+
+>
+- [Introduced][ee-109] in GitLab [Enterprise Edition Starter][ee] 8.4.
+- This is the user documentation. To install and configure Elasticsearch,
+  visit the [admin docs](../../integration/elasticsearch.md).
+
+Leverage Elasticsearch for faster, more advanced code search across your entire
+GitLab instance.
+
+## Overview
+
+Global code search in GitLab is a powerful search service that saves developers
+time. Instead of creating duplicate code and wasting time, they can now search
+for code within other teams that will help their own project.
+
+GitLab leverages the search capabilities of Elasticsearch and enables it when
+searching in:
+
+- GitLab application
+- Issues
+- Merge requests
+- Milestones
+- Notes
+- Projects
+- Repositories
+- Snippets
+- Wiki
+
+## Use cases
+
+1. If you are looking to enable innersourcing, with Global code search ...
+1. You want to keep GitLab's search fast when dealing with huge amount of data.
+
+## Searching globally
+
+You can also use the [advanced search syntax](advanced_search_syntax.md) which
+provides some useful queries.
+
+[ee-1305]: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1305
+[aws-elastic]: http://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-gsg.html
+[aws-iam]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html
+[aws-instance-profile]: http://docs.aws.amazon.com/codedeploy/latest/userguide/getting-started-create-iam-instance-profile.html#getting-started-create-iam-instance-profile-cli
+[ee-109]: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/109 "Elasticsearch Merge Request"
+[elasticsearch]: https://www.elastic.co/products/elasticsearch "Elasticsearch website"
+[install]: https://www.elastic.co/guide/en/elasticsearch/reference/current/_installation.html "Elasticsearch installation documentation"
+[pkg]: https://about.gitlab.com/downloads/ "Download Omnibus GitLab"
+[elastic-settings]: https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-configuration.html#settings "Elasticsearch configuration settings"
+[ee]: https://about.gitlab.com/gitlab-ee/

doc/user/search/index.md

@@ -103,12 +103,16 @@ and **Labels**, select multiple issues to add to a list of your choice:
 
 ![search and select issues to add to board](img/search_issues_board.png)
 
-## Advanced search syntax
+## Global code search
+
+Leverage Elasticsearch for faster, more advanced code search across your entire
+GitLab instance.
 
-> Available in [GitLab Enterprise Edition Premium][ee].
+[Learn how to use the global code search.](global_code_search.md)
+
+## Advanced search syntax
 
-If the [Elasticsearch integration](../../integration/elasticsearch.md) is
-enabled, then some advanced search functionality is available.
+Use advanced queries for more targeted search results.
 
 [Learn how to use the advanced search syntax.](advanced_search_syntax.md)