From 0834813ed5bb976fbe22ab5e08cf8675cce46ba6 Mon Sep 17 00:00:00 2001
From: Nick Fagerlund <nick.fagerlund@gmail.com>
Date: Thu, 14 Mar 2019 16:16:54 +0000
Subject: [PATCH] website: Write new content for CLI docs front page

---
 website/docs/cli-index.html.md | 41 +++++++++++++++++++++++++++++-----
 1 file changed, 35 insertions(+), 6 deletions(-)

diff --git a/website/docs/cli-index.html.md b/website/docs/cli-index.html.md
index 5329003dc..9c362d423 100644
--- a/website/docs/cli-index.html.md
+++ b/website/docs/cli-index.html.md
@@ -3,12 +3,41 @@ layout: "docs"
 page_title: "Documentation"
 sidebar_current: "docs-home"
 description: |-
-  Welcome to the Terraform documentation! This documentation is more of a reference guide for all available features and options of Terraform. If you're just getting started with Terraform, please start with the introduction and getting started guide instead.
+  Documentation for Terraform's core open source features, including the
+  configuration language, the commands, and the main Terraform providers.
 ---
 
-# Terraform Documentation
+# Terraform CLI Documentation
 
-Welcome to the Terraform documentation! This documentation is more of a reference
-guide for all available features and options of Terraform. If you're just getting
-started with Terraform, please start with the
-[introduction and getting started guide](/intro/index.html) instead.
+Welcome to the Terraform CLI documentation!
+
+## What's in This Section of the Docs?
+
+This section contains reference documentation for Terraform's core open source
+features, including the
+[configuration language](/docs/configuration/index.html), the
+[command-line tools](/docs/commands/index.html), and the main
+[Terraform providers](/docs/providers/index.html). Use the navigation sidebar
+to browse the various subsections.
+
+## Who is This For?
+
+The Terraform CLI docs are relevant to _all Terraform users,_ including open
+source users and Terraform Enterprise users.
+
+Since these docs are reference material, they are mainly written for
+_intermediate and advanced users,_ who need to find complete and detailed
+information quickly.
+
+- **New user?** Try the
+  [Getting Started guide](https://learn.hashicorp.com/terraform/getting-started/install.html)
+  at [Learn Terraform](https://learn.hashicorp.com/terraform), then return
+  here once you've used Terraform to manage some simple resources.
+- **Curious about Terraform?** See [Introduction to Terraform](/intro/index.html)
+  for a broad overview of what Terraform is and why people use it.
+
+## What's Elsewhere?
+
+This is not the only section of the Terraform docs! You can find out more at the
+[Terraform docs home page](/docs/index.html), or you can jump between sections
+using the "Other Docs" area of the navigation sidebar.