Update README (#56)

Updates README.

Author: afroozeh

Icon128.png

@@ -1,66 +1,16 @@
 # Kotlin Grammar for Tree-sitter
 
-[![Build](https://github.com/fwcd/tree-sitter-kotlin/actions/workflows/build.yml/badge.svg)](https://github.com/fwcd/tree-sitter-kotlin/actions/workflows/build.yml)
-[![NPM](https://img.shields.io/npm/v/tree-sitter-kotlin)](https://www.npmjs.com/package/tree-sitter-kotlin)
-[![crates.io](https://img.shields.io/crates/v/tree-sitter-kotlin)](https://crates.io/crates/tree-sitter-kotlin)
+Gitar’s Kotlin grammar for Tree-sitter began as a fork of [tree-sitter-kotlin](https://github.com/fwcd/tree-sitter-kotlin). Our goal is to provide a Kotlin grammar tailored for **program analysis**, not just syntax highlighting. This requires correctness and adherence to the Kotlin compiler. Over time, our grammar has diverged so much from the fork that it effectively stands as a new grammar.  
 
-[Kotlin](https://kotlinlang.org) language grammar for [Tree-sitter](http://tree-sitter.github.io/tree-sitter/). You can try it out directly [on the web](https://fwcd.github.io/tree-sitter-kotlin).
-
-![Icon](Icon128.png)
-
-The grammar is based on the [official language grammar](https://kotlinlang.org/docs/reference/grammar.html).
-
-## Project Structure
-
-| File | Description |
-| ---- | ----------- |
-| grammar.js | The Tree-sitter grammar |
-| grammar-reference.js | A direct translation of the Kotlin language grammar that is, however, ambiguous to Tree-sitter |
-| src | The generated parser |
+- The original repo is based on the [Kotlin specification grammar](https://kotlinlang.org/docs/reference/grammar.html), which only loosely reflects the compiler’s actual grammar. Our grammar more closely matches the compiler.  
+- We handle newline characters directly in the grammar rules to take advantage of full parser context. See our [blog post](https://gitar.ai/blog/parsing-kotlin) for details on newline handling in Kotlin.  
+- Some lexer hacks are still needed for newline handling — for example, distinguishing newlines after binary operators (to avoid conflicts with operator precedence) and ignoring newlines inside brackets.  
+- For program analysis, whitespace and comments often need to be properly attached to nodes. To support this, we’ve split some rules (such as class_declaration) so that whitespace and comments become part of the intended node.
 
 ## Setup
 
->`npm install`
-
-## Development
-
-### Compilation
-
-To (re-)compile the grammar, run:
-
->`npm run generate`
-
-Note that the grammar is written completely in JavaScript (`grammar.js`), the other source files are generated by `tree-sitter`.
-
-### Testing
-
-To run the unit tests, run:
-
->`npm run test`
-
-## WebAssembly
-
-### Compilation
-
-First make sure to have [Emscripten](https://emscripten.org/) installed. If you use Homebrew, you can `brew install emscripten`. Then run:
-
->`npm run build-wasm`
-
-### Playground
-
-After compiling the grammar to WebAssembly, you can invoke
-
->`npm run playground`
-
-to launch an interactive editing environment that displays the parsed syntax tree on-the-fly in the browser. You can also view a deployed version of this playground [on the web](https://fwcd.github.io/tree-sitter-kotlin).
-
-![Screenshot](playground-screenshot.png)
-
-## Documentation
-
-More documentation on how to create Tree-sitter grammars [can be found here](https://tree-sitter.github.io/tree-sitter/creating-parsers).
-
-## See also
+To run the grammar, install the [tree-sitter-cli](https://crates.io/crates/tree-sitter-cli). From the project root:  
 
-* [Kotlin Language Server](https://github.com/fwcd/kotlin-language-server) for code completion, diagnostics and more
-* [Kotlin Debug Adapter](https://github.com/fwcd/kotlin-debug-adapter) for JVM debugging support
+- `tree-sitter generate` → Generates the `parser.c` file. (Note: the file is currently quite large — a known Tree-sitter issue. We’re working on ways to reduce the size.)  
+- `tree-sitter test` → Runs all tests in the `test/corpus` directory.  
+- `tree-sitter build --wasm` → Builds the WebAssembly (wasm) file, which you can use to run the local playground with `tree-sitter play`.