Simplify documentation tone and remove marketing language

Author: jdalton

README.md

@@ -6,21 +6,15 @@
 [![Follow @SocketSecurity](https://img.shields.io/twitter/follow/SocketSecurity?style=social)](https://twitter.com/SocketSecurity)
 [![Follow @socket.dev on Bluesky](https://img.shields.io/badge/[email protected]?style=social&logo=bluesky)](https://bsky.app/profile/socket.dev)
 
-TypeScript-first Package URL (purl) parser and builder. **Drop-in replacement** for [`packageurl-js`](https://socket.dev/npm/package/packageurl-js) with better types and zero dependencies.
-
-**Why use this?**
-- 🎯 **TypeScript-first**: Full type safety and IntelliSense
-- 📦 **Zero dependencies**: No supply chain bloat
-- ✅ **Spec compliant**: Implements [Package URL specification](https://github.com/package-url/purl-spec)
-- 🔨 **Builder API**: Fluent, ecosystem-specific builders
+TypeScript Package URL (purl) parser and builder. Drop-in replacement for [`packageurl-js`](https://socket.dev/npm/package/packageurl-js) with full type safety, zero dependencies, and spec compliance with the [Package URL specification](https://github.com/package-url/purl-spec).
 
 ## Installation
 
 ```sh
 pnpm install @socketregistry/packageurl-js
 ```
 
-**Package override** (recommended for drop-in replacement):
+**Drop-in replacement** via package override:
 ```json
 {
   "pnpm": {
@@ -35,7 +29,7 @@ pnpm install @socketregistry/packageurl-js
 
 ## Usage
 
-**Parse existing purls:**
+**Parse purls:**
 ```javascript
 import { PackageURL } from '@socketregistry/packageurl-js'
 
@@ -44,7 +38,7 @@ console.log(purl.name)      // 'lodash'
 console.log(purl.version)   // '4.17.21'
 ```
 
-**Build new purls (recommended):**
+**Build purls:**
 ```javascript
 import { PackageURLBuilder } from '@socketregistry/packageurl-js'
 
@@ -106,11 +100,11 @@ function processPurl(type: EcosystemString) {
 
 ## Documentation
 
-**[→ Complete API Reference](./docs/API.md)** - Full API documentation with detailed examples
+**[→ API Reference](./docs/API.md)** - Complete API documentation
 
-**[→ Usage Examples](./docs/EXAMPLES.md)** - Practical examples for common use cases
+**[→ Examples](./docs/EXAMPLES.md)** - Common use cases
 
-**[→ Builder Pattern Guide](./docs/BUILDERS.md)** - Comprehensive builder pattern documentation
+**[→ Builders](./docs/BUILDERS.md)** - Builder pattern guide
 
 ## Development
 

docs/API.md

@@ -1,6 +1,6 @@
 # API Reference
 
-Complete API reference for `@socketregistry/packageurl-js`. All parsing and validation methods throw errors on invalid input.
+API reference for `@socketregistry/packageurl-js`. All parsing and validation methods throw on invalid input.
 
 ## PackageURL
 
@@ -20,7 +20,7 @@ Create a new PackageURL instance with validation and normalization.
 - `qualifiers` - Additional qualifiers object (optional)
 - `subpath` - Subpath within package (optional)
 
-**Throws:** Error if validation fails
+**Throws:** On validation failure
 
 <details>
 <summary>Show example</summary>
@@ -74,7 +74,7 @@ Parse a purl string into a PackageURL instance.
 
 **Returns:** PackageURL instance
 
-**Throws:** Error if string is invalid
+**Throws:** On invalid string
 
 <details>
 <summary>Show example</summary>
@@ -112,7 +112,7 @@ Create a PackageURL from a JSON string representation.
 
 **Returns:** PackageURL instance
 
-**Throws:** Error if JSON is invalid
+**Throws:** On invalid JSON
 
 <details>
 <summary>Show example</summary>
@@ -141,7 +141,7 @@ Create a PackageURL from a plain object.
 
 **Returns:** PackageURL instance
 
-**Throws:** Error if object structure is invalid
+**Throws:** On invalid object structure
 
 <details>
 <summary>Show example</summary>
@@ -172,7 +172,7 @@ Parse a purl string into an array of components.
 
 **Returns:** Array of [type, namespace, name, version, qualifiers, subpath]
 
-**Throws:** Error if parsing fails
+**Throws:** On parse failure
 
 <details>
 <summary>Show example</summary>
@@ -657,7 +657,7 @@ Construct and return the final PackageURL instance.
 
 **Returns:** PackageURL instance
 
-**Throws:** Error if configuration is invalid
+**Throws:** On invalid configuration
 
 <details>
 <summary>Show example</summary>