Update README.md

README.md

@@ -10,22 +10,46 @@ pinned: false
 license: mit
 short_description: 'Turn .md / .txt into csv '
 ---
-This tool converts structured chat transcripts written in markdown or plain text into a canonical turn-level CSV format suitable for analysis with Threadscope: Drift & Hold.
+## What this tool does
 
-Supported Format:
-This convertor expects transcripts that use explicit speaker markers, for example:
-You said: Hello
-ChatGPT said: Hi there
-Marker strings are configurable in the UI, but the transcript must follow a consistent "marker to content" pattern
+This tool converts structured chat transcripts written in Markdown or plain text
+into a canonical turn-level CSV format suitable for analysis with **Threadscope:
+Drift & Hold**.
 
-Not supported:
-Arbitarily formatted prose
-Chat logs without speaker markers
-Exported HTML/JSON without preprocessing (in process - update coming soon)
+## Supported transcript format
 
-Output: 
-The output CSV includes: turn, speaker, chars, words, tokens_est (lightweight est.)
+This converter expects transcripts that use explicit speaker markers, for example:
+
+- 'You said: Hello'
+- 'ChatGPT said: Hi there'
+
+Marker strings are configurable in the UI, but the transcript must follow a
+consistent “marker → content” pattern.
+
+## Not supported
+
+- Arbitrarily formatted prose
+- Chat logs without explicit speaker markers
+- Exported HTML or JSON without preprocessing
+
+## Output
+
+The generated CSV includes the following columns:
+
+- `turn`
+- `speaker`
+- `chars`
+- `words`
+- `tokens_est` (lightweight estimate)
+
+## How this fits into the Threadbourne lab
+
+This tool is intended as a preprocessing step for use with
+**Threadscope: Drift & Hold**, which visualizes long-form interaction dynamics
+such as drift, stability, and perturbation response.
+
+## Privacy
+
+Files are processed in-session only and are not stored.
 
-This tool is intended as a preprocessing step for use with Threadscope, which visualizes long-form interaction dynamics such as drift, stability, and perturbation response. 
-Files are processed in-session only and are not stored
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference