Update index.md

Author: codeamt

docs/index.md

@@ -1,28 +1,40 @@
 # PE-Packer (Educational)
 
-PE-Packer is an educational laboratory for learning about the Windows Portable Executable (PE) format, safe unpacking workflows, and defensive ML evaluation. It combines a Rust backend with Python bindings.
+PE‑Packer is an educational laboratory for learning the Windows Portable Executable (PE) format, safe unpacking workflows, and defensive ML evaluation. It combines a Rust backend with Python bindings and enforces strict safety gates.
 
-- Safety gates strictly enforced for packing.
-- Educational PyPI stub with no functional code.
-- Source install supports research and instruction.
+- Educational PyPI package is a non‑functional stub (prints guidance and policies).
+- Source install enables educational workflows for research and instruction.
 
-> See: SECURITY.md· LICENSE-APPENDIX.md
+See policies: `SECURITY.md` · `LICENSE-APPENDIX.md`
 
-## Safety Model (TL;DR)
+## Quick start (PyPI Stub)
 
-- Default: dry-run analysis only.
-- Actual packing requires both:
+Install and run the educational stub:
+
+```bash
+pip install rust-python-pe-packer
+pe-packer
+```
+
+This prints guidance and links to responsible‑use policies.
+
+## Safety model (TL;DR)
+
+- Default: analysis‑only dry run.
+- Actual packing requires BOTH:
   - `PE_PACKER_ALLOW_PACKING=1`
   - `--force`
 
-## Install (Source)
+Without both, commands do not write packed binaries.
+
+## Install from source (for education/research)
 
 ```bash
 uv sync --group dev --group training
 uv run maturin develop --features python
 ```
 
-## CLI Examples
+## CLI examples
 
 ```bash
 # Dry run (no env/--force)
@@ -31,3 +43,9 @@ pe-packer pack input.exe out.exe
 # Actual packing (requires both)
 PE_PACKER_ALLOW_PACKING=1 pe-packer pack input.exe out.exe --force
 ```
+
+## Next steps
+
+- Usage guide: `usage.md`
+- Safety & policy: `safety.md`
+- Architecture overview: `architecture.md`