From ccf02a554eef74f577e4b3b4fad21c9343347d4d Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Mon, 24 Aug 2026 17:01:13 +0000
Subject: [PATCH] docs: expand README for community install and contrib
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Document what the plugin does, the dripnex/plugin-math install
id, build/pack scripts, and a short contribution path.

Co-authored-by:  Tomás Maritano <tomymaritano@gmail.com>
---
 README.md | 38 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 03d2391..be61bf0 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,47 @@
 # Math
 
-Official [Dripnex](https://dripnex.app) plugin. Inserts a `$$` display-math fence.
+Official [Dripnex](https://dripnex.app) plugin. Inserts a `$$` display-math fence at the cursor.
 
 KaTeX preview ships with the desktop (`dripnex-math`). This repo is the installable community surface.
 
+## What it does
+
+Adds **Insert Math Block** (command `math:insert`) to insert this LaTeX fence at the cursor:
+
+```
+$$
+E = mc^2
+$$
+```
+
+KaTeX rendering ships with Dripnex. This plugin only inserts the fence.
+
+Plugin id: `math` (v0.1.0). Entry: `dist/index.js`.
+
 ## Install
 
 ```
 dripnex/plugin-math
 ```
+
+## Develop
+
+Source is CommonJS in `src/index.js`. The packed entry is `dist/index.js`.
+
+```bash
+npm run build   # copy src/index.js → dist/index.js
+npm run pack    # dripnex-plugin pack .
+```
+
+`pack` requires the `dripnex-plugin` CLI.
+
+## Contribute
+
+Issues and pull requests are welcome.
+
+1. Fork and clone this repo.
+2. Edit `src/` (keep CommonJS).
+3. Run `npm run build`.
+4. Open a focused pull request.
+
+MIT — see [LICENSE](LICENSE).