Clarify README

- Let's call it "guide" not "documentation" to be less ambiguous with the future API reference/our KDoc in general.
- The commit also adds a link to the Analysis API's sources in the Kotlin repo, since some users may find the guide repository when they're looking for the Analysis API itself.

Author: marcopennekamp

README.md

@@ -1,13 +1,15 @@
-# Kotlin Analysis API Documentation
+# Kotlin Analysis API Guide
 
 [![official project](http://jb.gg/badges/official.svg)](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-This repository contains documentation sources for the Kotlin Analysis API library.
-You might want to check the [generated documentation website](https://kotl.in/analysis-api).
+This repository contains documentation sources for the Kotlin Analysis API library. You might want to check the 
+[Analysis API guide](https://kotl.in/analysis-api) which is generated from this repository.
+
+The sources of the Analysis API itself live inside the [Kotlin language repository](https://github.com/JetBrains/kotlin/tree/master/analysis).
 
 ---
 
-The Analysis API is a powerful library for analyzing code in Kotlin.
-Built on top of the Kotlin PSI syntax tree, it provides access to various semantic information, including reference
-targets, expression types, declaration scopes, diagnostics, and more.
+The Analysis API is a powerful library for analyzing code in Kotlin. Built on top of the Kotlin PSI syntax tree, it 
+provides access to various semantic information, including reference targets, expression types, declaration scopes, 
+diagnostics, and more.