Reorganize docs

README.md

@@ -2,7 +2,7 @@
 
 # Searchlight
 
-<img src="/cover.jpg">
+<img src="/docs/images/cover.jpg">
 
 
 Searchlight by AppsCode is a Kubernetes operator for [Icinga](https://www.icinga.com/). If you are running production workloads in Kubernetes, you probably want to be alerted when things go wrong. Icinga periodically runs various checks on a Kubernetes cluster and sends notifications if detects an issue. It also nicely supplements whitebox monitoring tools like, [Prometheus](https://prometheus.io/) with blackbox monitoring can catch problems that are otherwise invisible, and also serves as a fallback in case internal systems completely fail. Searchlight is a CRD controller for Kubernetes built around Icinga to address these issues. Searchlight can do the following things for you:
@@ -17,20 +17,20 @@ Please pick a version of Searchlight that matches your Kubernetes installation.
 
 | Searchlight Version | Docs | Kubernetes Version |
 |------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|--------------------|
-| [4.0.0](https:/appscode/searchlight/releases/tag/4.0.0) (uses CRD) | [User Guide](https:/appscode/searchlight/tree/4.0.0/docs) | 1.7.x+ |
+| [4.0.0](https:/appscode/searchlight/releases/tag/4.0.0) (uses CRD)  | [User Guide](https:/appscode/searchlight/tree/4.0.0/docs) | 1.7.x+ |
 | [3.0.1](https:/appscode/searchlight/releases/tag/3.0.1) (uses TPR) | [User Guide](https:/appscode/searchlight/tree/3.0.1/docs) | 1.5.x - 1.7.x |
 
 ## Installation
-To install Searchlight, please follow the guide [here](/docs/install.md).
+To install Searchlight, please follow the guide [here](/docs/setup/install.md).
 
 ## Using Searchlight
-Want to learn how to use Searchlight? Please start [here](/docs/tutorials/README.md).
+Want to learn how to use Searchlight? Please start [here](/docs/guides/README.md).
 
 ## Contribution guidelines
-Want to help improve Searchlight? Please start [here](/CONTRIBUTING.md).
+Want to help improve Searchlight? Please start [here](/docs/CONTRIBUTING.md).
 
 ## Project Status
-Wondering what features are coming next? Please visit [here](/ROADMAP.md).
+Wondering what features are coming next? Please visit [here](/docs/roadmap.md).
 
 ---
 

CONTRIBUTING.md → docs/CONTRIBUTING.md

@@ -1,7 +1,24 @@
+---
+title: Contributing | Searchlight
+description: Contributing
+menu:
+ product_searchlight_4.0.0:
+ identifier: contributing-searchlight
+ name: Contributing
+ parent: welcome
+ weight: 10
+product_name: searchlight
+menu_name: product_searchlight_4.0.0
+section_menu_id: welcome
+url: /products/searchlight/4.0.0/welcome/contributing/
+aliases:
+ - /products/searchlight/4.0.0/CONTRIBUTING/
+---
+
 # Contribution Guidelines
 Want to hack on Searchlight?
 
-AppsCode projects are [Apache 2.0 licensed](LICENSE) and accept contributions via
+AppsCode projects are [Apache 2.0 licensed](https:/appscode/searchlight/blob/master/LICENSE) and accept contributions via
 GitHub pull requests. This document outlines some of the conventions on
 development workflow, commit message formatting, contact points and other
 resources to make it easier to get your contribution accepted.
@@ -11,25 +28,21 @@ resources to make it easier to get your contribution accepted.
 By contributing to this project you agree to the Developer Certificate of
 Origin (DCO). This document was created by the Linux Kernel community and is a
 simple statement that you, as a contributor, have the legal right to make the
-contribution. See the [DCO](DCO) file for details.
+contribution. See the [DCO](https:/appscode/searchlight/blob/master/DCO) file for details.
 
 ## Developer Guide
 
-We have a [Developer Guide](/docs/developer-guide/README.md) that outlines everything you need to know from setting up your
+We have a [Developer Guide](/docs/setup/developer-guide/README.md) that outlines everything you need to know from setting up your
 dev environment to how to build and test Searchlight. If you find something undocumented or incorrect along the way,
 please feel free to send a Pull Request.
 
-## Design Docs
-
-If you want to know how Searchlight translates Alert CRDs into Icinga parlance, read the [design doc](docs/design/README.md).
-
 ## Getting Help
 
 If you have a question about Searchlight or having problem using it, you can contact us on our public Slack channel. Follow [this link](https://slack.appscode.com) to get invitation to our Slack channel.
 
 ## Bugs/Feature request
 
-If you have found a bug with Searchlight or want to request for new features, please [file an issue](https:/appscode/searchlight/issues/new). 
+If you have found a bug with Searchlight or want to request for new features, please [file an issue](https:/appscode/searchlight/issues/new).
 
 ## Submit PR
 

docs/README.md

@@ -1,67 +1,45 @@
 ---
-title: Overview | Searchlight
-description: Overview of Searchlight
+title: Readme | Searchlight
+description: Readme of Searchlight
 menu:
  product_searchlight_4.0.0:
- identifier: overview-searchlight
- name: Overview
- parent: getting-started
- weight: 20
+ identifier: readme-searchlight
+ name: Readme
+ parent: welcome
+ weight: -1
 product_name: searchlight
 menu_name: product_searchlight_4.0.0
-section_menu_id: getting-started
-url: /products/searchlight/4.0.0/getting-started/
+section_menu_id: welcome
+url: /products/searchlight/4.0.0/welcome/
 aliases:
  - /products/searchlight/4.0.0/
  - /products/searchlight/4.0.0/README/
 ---
-
-[![Go Report Card](https://goreportcard.com/badge/github.com/appscode/searchlight)](https://goreportcard.com/report/github.com/appscode/searchlight)
-
 # Searchlight
 
-<img src="/cover.jpg">
-
-
-Searchlight by AppsCode is a Kubernetes operator for [Icinga](https://www.icinga.com/). If you are running production workloads in Kubernetes, you probably want to be alerted when things go wrong. Icinga periodically runs various checks on a Kubernetes cluster and sends notifications if detects an issue. It also nicely supplements whitebox monitoring tools like, [Prometheus](https://prometheus.io/) with blackbox monitoring can catch problems that are otherwise invisible, and also serves as a fallback in case internal systems completely fail. Searchlight is a CRD controller for Kubernetes built around Icinga to address these issues. Searchlight can do the following things for you:
+<img src="/docs/images/cover.jpg">
 
- - Periodically run various checks on a Kubernetes cluster and its nodes or pods.
- - Includes a [suite of check commands](/docs/reference/hyperalert/hyperalert.md) written specifically for Kubernetes.
- - Searchlight can send notifications via Email, SMS or Chat.
- - [Supplements](https://prometheus.io/docs/practices/alerting/#metamonitoring) the whitebox monitoring tools like [Prometheus](https://prometheus.io).
+Searchlight by AppsCode is a Kubernetes operator for [Icinga](https://www.icinga.com/). If you are running production workloads in Kubernetes, you probably want to be alerted when things go wrong. Icinga periodically runs various checks on a Kubernetes cluster and sends notifications if detects an issue. It also nicely supplements whitebox monitoring tools like, [Prometheus](https://prometheus.io/) with blackbox monitoring can catch problems that are otherwise invisible, and also serves as a fallback in case internal systems completely fail.
 
-## Supported Versions
-Please pick a version of Searchlight that matches your Kubernetes installation.
+From here you can learn all about Searchlight's architecture and how to deploy and use Searchlight.
 
-| Searchlight Version | Docs | Kubernetes Version |
-|------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|--------------------|
-| [4.0.0](https:/appscode/searchlight/releases/tag/4.0.0) (uses CRD) | [User Guide](https:/appscode/searchlight/tree/4.0.0/docs) | 1.7.x+ |
-| [3.0.1](https:/appscode/searchlight/releases/tag/3.0.1) (uses TPR) | [User Guide](https:/appscode/searchlight/tree/3.0.1/docs) | 1.5.x - 1.7.x |
+- [Concepts](/docs/concepts/). Concepts explain some significant aspect of Searchlight. This is where you can learn about what Searchlight does and how it does it.
 
-## Installation
-To install Searchlight, please follow the guide [here](/docs/install.md).
+- [Setup](/docs/setup/). Setup contains instructions for installing
+ the Searchlight in various cloud providers.
 
-## Using Searchlight
-Want to learn how to use Searchlight? Please start [here](/docs/tutorials/README.md).
+- [Guides](/docs/guides/). Guides show you how to perform tasks with Searchlight.
 
-## Contribution guidelines
-Want to help improve Searchlight? Please start [here](/CONTRIBUTING.md).
-
-## Project Status
-Wondering what features are coming next? Please visit [here](/ROADMAP.md).
-
----
+- [Reference](/docs/reference/). Detailed exhaustive lists of command-line options, configuration options, API definitions, and procedures.
 
-**The searchlight operator collects anonymous usage statistics to help us learn how the software is being used and
-how we can improve it. To disable stats collection, run the operator with the flag** `--analytics=false`.
+We're always looking for help improving our documentation, so please don't hesitate to
+[file an issue](https:/appscode/searchlight/issues/new) if you see some problem.
+Or better yet, submit your own [contributions](/docs/CONTRIBUTING.md) to help
+make our docs better.
 
 ---
 
-## Acknowledgement
- - Many thanks to [Icinga](https://www.icinga.com/) project.
+**Searchlight binaries collects anonymous usage statistics to help us learn how the software is being used and how we can improve it.
+To disable stats collection, run the operator with the flag** `--analytics=false`.
 
-## Support
-If you have any questions, you can reach out to us.
-* [Slack](https://slack.appscode.com)
-* [Twitter](https://twitter.com/AppsCodeHQ)
-* [Website](https://appscode.com)
+---

docs/_index.md

@@ -3,8 +3,8 @@ title: Docs | Searchlight
 description: Searchlight Docs
 menu:
  product_searchlight_4.0.0:
- identifier: getting-started
- name: Getting Started
+ identifier: welcome
+ name: Welcome
  weight: 10
 menu_name: product_searchlight_4.0.0
----
+---

docs/acknowledgement.md

@@ -0,0 +1,19 @@
+---
+title: Acknowledgement | Searchlight
+description: Acknowledgement
+menu:
+ product_searchlight_4.0.0:
+ identifier: acknowledgement-searchlight
+ name: Acknowledgement
+ parent: welcome
+ weight: 20
+product_name: searchlight
+menu_name: product_searchlight_4.0.0
+section_menu_id: welcome
+url: /products/searchlight/4.0.0/welcome/acknowledgement/
+aliases:
+ - /products/searchlight/4.0.0/acknowledgement/
+---
+
+# Acknowledgement
+ - Many thanks to [Icinga](https://www.icinga.com/) project.

docs/concepts/README.md

@@ -0,0 +1,25 @@
+---
+title: Concepts | Searchlight
+menu:
+ product_searchlight_4.0.0:
+ identifier: concepts-readme
+ name: Readme
+ parent: concepts
+ weight: -1
+product_name: searchlight
+menu_name: product_searchlight_4.0.0
+section_menu_id: concepts
+url: /products/searchlight/4.0.0/concepts/
+aliases:
+ - /products/searchlight/4.0.0/concepts/README/
+---
+# Concepts
+
+Concepts help you learn about the different parts of the Searchlight and the abstractions it uses.
+
+- What is Searchlight?
+ - [Overview](/docs/concepts/what-is-searhclight/overview.md). Provides a conceptual introduction to Searchlight, including the problems it solves and its high-level architecture.
+- Types of Alerts
+ - [ClusterAlerts](/docs/concepts/alert-types/cluster-alert.md). Introduces the concept of `ClusterAlert` to periodically run various checks on a Kubernetes cluster.
+ - [NodeAlerts](/docs/concepts/alert-types/node-alert.md). Introduces the concept of `NodeAlert` to periodically run various checks on nodes in a Kubernetes cluster.
+ - [PodAlerts](/docs/concepts/alert-types/pod-alert.md). Introduces the concept of `PodAlert` to periodically run various checks on pods in a Kubernetes cluster.

docs/tutorials/_index.md → docs/concepts/_index.md

@@ -1,9 +1,10 @@
 ---
-title: Tutorials | Searchlight
+title: Concepts
+description: Searchlight Concepts
 menu:
  product_searchlight_4.0.0:
- identifier: tutorials
- name: Tutorials
+ identifier: concepts
+ name: Concepts
  weight: 20
 menu_name: product_searchlight_4.0.0
 ---

docs/concepts/alert-types/_index.md

@@ -0,0 +1,11 @@
+---
+title: Types of Alerts
+description: Types of Alerts
+menu:
+ product_searchlight_4.0.0:
+ identifier: alert-types
+ parent: concepts
+ name: Types of Alerts
+ weight: 15
+menu_name: product_searchlight_4.0.0
+---

docs/tutorials/cluster-alerts/README.md → docs/concepts/alert-types/cluster-alert.md

@@ -3,19 +3,15 @@ title: Cluster Alert Overview
 menu:
  product_searchlight_4.0.0:
  identifier: cluster-alert-overview
- name: Overview
- parent: cluster-alert
+ name: Cluster Alert
+ parent: alert-types
  weight: 5
 product_name: searchlight
 menu_name: product_searchlight_4.0.0
-section_menu_id: tutorials
-url: /products/searchlight/4.0.0/tutorials/cluster-alerts/
-aliases:
- - /products/searchlight/4.0.0/tutorials/cluster-alerts/README/
+section_menu_id: concepts
 ---
 
-> New to Searchlight? Please start [here](/docs/tutorials/README.md).
-
+> New to Searchlight? Please start [here](/docs/concepts/README.md).
 # ClusterAlerts
 
 ## What is ClusterAlert
@@ -58,12 +54,12 @@ Any ClusterAlert object has 2 main sections:
 ### Check Command
 Check commands are used by Icinga to periodically test some condition. If the test return positive appropriate notifications are sent. The following check commands are supported for pods:
 
-- [ca_cert](/docs/tutorials/cluster-alerts/ca_cert.md) - To check expiration of CA certificate used by Kubernetes api server.
-- [component_status](/docs/tutorials/cluster-alerts/component_status.md) - To check Kubernetes component status.
-- [event](/docs/tutorials/cluster-alerts/event.md) - To check Kubernetes Warning events.
-- [json_path](/docs/tutorials/cluster-alerts/json_path.md) - To check any JSON HTTP response using [jq](https://stedolan.github.io/jq/).
-- [node_exists](/docs/tutorials/cluster-alerts/node_exists.md) - To check existence of Kubernetes nodes.
-- [pod_exists](/docs/tutorials/cluster-alerts/pod_exists.md) - To check existence of Kubernetes pods.
+- [ca_cert](/docs/guides/cluster-alerts/ca_cert.md) - To check expiration of CA certificate used by Kubernetes api server.
+- [component_status](/docs/guides/cluster-alerts/component_status.md) - To check Kubernetes component status.
+- [event](/docs/guides/cluster-alerts/event.md) - To check Kubernetes Warning events.
+- [json_path](/docs/guides/cluster-alerts/json_path.md) - To check any JSON HTTP response using [jq](https://stedolan.github.io/jq/).
+- [node_exists](/docs/guides/cluster-alerts/node_exists.md) - To check existence of Kubernetes nodes.
+- [pod_exists](/docs/guides/cluster-alerts/pod_exists.md) - To check existence of Kubernetes pods.
 
 Each check command has a name specified in `spec.check` field. Optionally each check command can take one or more parameters. These are specified in `spec.vars` field. To learn about the available parameters for each check command, please visit their documentation. `spec.checkInterval` specifies how frequently Icinga will perform this check. Some examples are: 30s, 5m, 6h, etc.
 
@@ -83,14 +79,14 @@ You can skip this section if you are unfamiliar with how Icinga works. Searchlig
 
 ## Next Steps
  - Visit the links below to learn about the available check commands for a cluster:
- - [ca_cert](/docs/tutorials/cluster-alerts/ca_cert.md) - To check expiration of CA certificate used by Kubernetes api server.
- - [component_status](/docs/tutorials/cluster-alerts/component_status.md) - To check Kubernetes component status.
- - [event](/docs/tutorials/cluster-alerts/event.md) - To check Kubernetes Warning events.
- - [json_path](/docs/tutorials/cluster-alerts/json_path.md) - To check any JSON HTTP response using [jq](https://stedolan.github.io/jq/).
- - [node_exists](/docs/tutorials/cluster-alerts/node_exists.md) - To check existence of Kubernetes nodes.
- - [pod_exists](/docs/tutorials/cluster-alerts/pod_exists.md) - To check existence of Kubernetes pods.
- - To periodically run various checks on nodes in a Kubernetes cluster, use [NodeAlerts](/docs/tutorials/node-alerts/README.md).
- - To periodically run various checks on pods in a Kubernetes cluster, use [PodAlerts](/docs/tutorials/pod-alerts/README.md).
- - See the list of supported notifiers [here](/docs/tutorials/notifiers.md).
- - Wondering what features are coming next? Please visit [here](/ROADMAP.md).
- - Want to hack on Searchlight? Check our [contribution guidelines](/CONTRIBUTING.md).
+ - [ca_cert](/docs/guides/cluster-alerts/ca_cert.md) - To check expiration of CA certificate used by Kubernetes api server.
+ - [component_status](/docs/guides/cluster-alerts/component_status.md) - To check Kubernetes component status.
+ - [event](/docs/guides/cluster-alerts/event.md) - To check Kubernetes Warning events.
+ - [json_path](/docs/guides/cluster-alerts/json_path.md) - To check any JSON HTTP response using [jq](https://stedolan.github.io/jq/).
+ - [node_exists](/docs/guides/cluster-alerts/node_exists.md) - To check existence of Kubernetes nodes.
+ - [pod_exists](/docs/guides/cluster-alerts/pod_exists.md) - To check existence of Kubernetes pods.
+ - To periodically run various checks on nodes in a Kubernetes cluster, use [NodeAlerts](/docs/concepts/alert-types/node-alert.md).
+ - To periodically run various checks on pods in a Kubernetes cluster, use [PodAlerts](/docs/concepts/alert-types/pod-alert.md).
+ - See the list of supported notifiers [here](/docs/guides/notifiers.md).
+ - Wondering what features are coming next? Please visit [here](/docs/roadmap.md).
+ - Want to hack on Searchlight? Check our [contribution guidelines](/docs/CONTRIBUTING.md).