Index: lldb/docs/index.rst
===================================================================
--- lldb/docs/index.rst
+++ lldb/docs/index.rst
@@ -17,20 +17,22 @@
 
 .. _"Apache 2.0 License with LLVM exceptions": https://llvm.org/docs/DeveloperPolicy.html#new-llvm-project-license-framework
 
-Why a New Debugger?
--------------------
+Using LLDB
+----------
 
-In order to achieve our goals we decided to start with a fresh architecture
-that would support modern multi-threaded programs, handle debugging symbols in
-an efficient manner, use compiler based code knowledge and have plug-in support
-for functionality and extensions. Additionally we want the debugger
-capabilities to be available to other analysis tools, be they scripts or
-compiled programs, without requiring them to be GPL.
+For an introduction into the LLDB command language, head over to the
+:ref:`LLDB Tutorial <use/tutorial>`. For users already familiar with
+other debuggers there is also a cheat sheet listing common tasks and
+their LLDB equivalent in the :ref:`GDB to LLDB command map <use/map>`.
+
+There are also multiple resources on how to script LLDB using Pythonl
+:ref:`Python Reference <use/python-reference>` is a great staring
+point for that.
 
 Compiler Integration Benefits
 -----------------------------
 
-LLDB currently converts debug information into clang types so that it can
+LLDB converts debug information into Clang types so that it can
 leverage the clang compiler infrastructure. This allows LLDB to support the
 latest C, C++, Objective-C and Objective-C++ language features and runtimes in
 expressions without having to reimplement any of this functionality. It also
@@ -132,13 +134,13 @@
    use/python-reference
    use/remote
    use/troubleshooting
-   use/architecture
 
 .. toctree::
    :hidden:
    :maxdepth: 1
    :caption: Development
 
+   resources/architecture
    resources/contributing
    resources/build
    resources/test
Index: lldb/docs/status/goals.rst
===================================================================
--- lldb/docs/status/goals.rst
+++ lldb/docs/status/goals.rst
@@ -31,3 +31,14 @@
 * Great support for C, Objective-C and C++
 * Retargetable to support multiple platforms
 * Provide a base for debugger research and other innovation
+
+Why a New Debugger?
+-------------------
+
+In order to achieve our goals we decided to start with a fresh architecture
+that would support modern multi-threaded programs, handle debugging symbols in
+an efficient manner, use compiler based code knowledge and have plug-in support
+for functionality and extensions. Additionally we want the debugger
+capabilities to be available to other analysis tools, be they scripts or
+compiled programs, without requiring them to be GPL.
+