docs: add CRATE_USAGE.md, fix CONTRIBUTING.md code fence, update .gitignore for crate doc inclusion

- Added CRATE_USAGE.md for crate-specific usage and examples
- CONTRIBUTING.md: use bash code fence for pre-commit hook setup instructions
- .gitignore: allow CRATE_USAGE.md to be tracked
- OVERVIEW.md: minor formatting and code block language tweaks

All changes maintain documentation compliance and improve developer experience.

Author: nerdCopter

.gitignore

@@ -11,6 +11,7 @@
 !LICENSE
 !LICENSE_COMMERCIAL
 !CONTRIBUTING.md
+!CRATE_USAGE.md
 
 # Whitelist src directory and all Rust files within it
 !src/

CONTRIBUTING.md

@@ -34,7 +34,7 @@ By submitting a pull request or otherwise contributing code to this project, you
 - Add comments for complex or non-obvious code sections.
 - Enable the pre-commit formatting hook (recommended):
 
-```
+```bash
 cp .github/pre-commit-hook.sh .git/hooks/pre-commit
 chmod +x .git/hooks/pre-commit
 ```

CRATE_USAGE.md

@@ -0,0 +1,96 @@
+# Crate Usage: bbl_parser
+
+Focused guidance for using the bbl_parser Rust crate.
+
+## Table of Contents
+- [Installation](#installation)
+- [Cargo features](#cargo-features)
+- [Basic usage](#basic-usage)
+- [Multi-log processing](#multi-log-processing)
+- [Parsing from memory](#parsing-from-memory)
+- [Examples](#examples)
+- [Notes](#notes)
+
+## Installation
+
+Add the dependency to your Cargo.toml:
+
+```toml
+[dependencies]
+# Local path while developing; use a version when published
+bbl_parser = { path = "path/to/bbl_parser" }
+```
+
+## Cargo features
+
+- `csv` (default): CSV export helpers
+- `cli` (default): Command-line entry points
+- `json`: JSON-related helpers (requires `serde`)
+- `serde`: Enable serialization for data structures
+
+If you only need the parser types and functions, the defaults are fine.
+
+## Basic usage
+
+```rust
+use bbl_parser::{parse_bbl_file, ExportOptions};
+use std::path::Path;
+
+fn main() -> anyhow::Result<()> {
+    let log = parse_bbl_file(Path::new("flight.BBL"), ExportOptions::default(), false)?;
+    println!("firmware: {}", log.header.firmware_revision);
+    println!("frames: {}", log.sample_frames.len());
+    Ok(())
+}
+```
+
+Key outputs on the BBLLog:
+- `header`: configuration and metadata
+- `sample_frames`: decoded I/P/S/G/H/E frames
+- `event_frames`: flight events (when present)
+- `gps_track`: GPS coordinates (when present)
+
+## Multi-log processing
+
+```rust
+use bbl_parser::{parse_bbl_file_all_logs, ExportOptions};
+use std::path::Path;
+
+fn main() -> anyhow::Result<()> {
+    let logs = parse_bbl_file_all_logs(Path::new("multi_flight.BBL"), ExportOptions::default(), false)?;
+    for log in logs {
+        println!("log {} of {} -> frames {}", log.log_number, log.total_logs, log.sample_frames.len());
+    }
+    Ok(())
+}
+```
+
+## Parsing from memory
+
+```rust
+use bbl_parser::{parse_bbl_bytes, ExportOptions};
+
+fn main() -> anyhow::Result<()> {
+    let bytes = std::fs::read("flight.BBL")?;
+    let log = parse_bbl_bytes(&bytes, ExportOptions::default(), false)?;
+    println!("frames: {}", log.sample_frames.len());
+    Ok(())
+}
+```
+
+## Examples
+
+Run the crate example that demonstrates multi-firmware support and PID extraction:
+
+```bash
+cargo build --example bbl_crate_test
+cargo run --example bbl_crate_test -- flight.BBL
+```
+
+More details: [examples/README.md](./examples/README.md)
+
+## Notes
+
+- API is evolving while the project is WIP; names and structures may change.
+- CSV field order and naming follow blackbox-tools to maximize compatibility.
+- For CLI usage and high-level overview, see the main [README](./README.md).

OVERVIEW.md

@@ -87,7 +87,7 @@ The BBL parser implements a streaming architecture designed for memory efficienc
 BBL encoding compatibility: `SIGNED_VB`, `UNSIGNED_VB`, `NEG_14BIT`, `TAG8_8SVB`, `TAG2_3S32`, `TAG8_4S16`
 
 ### **Project Structure**
-```
+```text
 src/
 ├── main.rs              # CLI interface, file handling, statistics, CSV export
 ├── lib.rs               # Library API exports and documentation
@@ -119,7 +119,7 @@ src/
 - **Firmware Compatibility:** Betaflight, EmuFlight, INAV support
 - **Multi-log Processing:** Automatic detection of multiple flight sessions in single files
 - **Smart Export Filtering:** Automatically skips short test flights (<5s) while preserving high-quality short logs
-
+stub
 ### **Library API**
 - **Complete Data Access:** Programmatic access to all BBL data structures
 - **Memory-Based Parsing:** Parse from file paths or memory buffers (`parse_bbl_file`, `parse_bbl_bytes`)