docs: use modest claims in documentation

- Remove "drop-in replacement" and "100% API compatible" claims
- Replace with "feedparser-compatible API" and "familiar API"
- Remove specific performance numbers, use general "high-performance"
- Update all README files, pyproject.toml, and package.json
- Fix repository URLs in Python README

Author: bug-ops

README.md

@@ -6,15 +6,15 @@
 [![npm](https://img.shields.io/npm/v/feedparser-rs)](https://www.npmjs.com/package/feedparser-rs)
 [![License](https://img.shields.io/crates/l/feedparser-rs)](LICENSE-MIT)
 
-High-performance RSS/Atom/JSON Feed parser for Rust, with Python and Node.js bindings. A drop-in replacement for Python's `feedparser` library with 10-100x performance improvement.
+High-performance RSS/Atom/JSON Feed parser written in Rust, with Python and Node.js bindings.
 
 ## Features
 
 - **Multi-format support** — RSS 0.9x, 1.0, 2.0 / Atom 0.3, 1.0 / JSON Feed 1.0, 1.1
-- **Tolerant parsing** — Handles malformed feeds with `bozo` flag pattern (like Python feedparser)
-- **HTTP fetching** — Built-in support for fetching feeds from URLs with compression
+- **Tolerant parsing** — Handles malformed feeds gracefully with `bozo` flag pattern
+- **HTTP fetching** — Built-in URL fetching with compression support (gzip, deflate, brotli)
 - **Multi-language bindings** — Native Python (PyO3) and Node.js (napi-rs) bindings
-- **feedparser-compatible API** — 100% API compatibility with Python feedparser
+- **Familiar API** — Inspired by Python's feedparser, easy to migrate existing code
 
 ## Installation
 
@@ -132,7 +132,7 @@ print(d.entries[0].published_parsed)  # time.struct_time
 ```
 
 > [!NOTE]
-> Python bindings provide `time.struct_time` for date fields, matching the original feedparser API.
+> Python bindings provide `time.struct_time` for date fields, similar to feedparser's API.
 
 ## Cargo Features
 
@@ -153,7 +153,7 @@ This repository contains multiple crates:
 
 | Crate | Description | Package |
 |-------|-------------|---------|
-| [`feedparser-rs`](crates/feedparser-rs) | Core Rust parser | [crates.io](https://crates.io/crates/feedparser-rs) |
+| [`feedparser-rs`](crates/feedparser-rs-core) | Core Rust parser | [crates.io](https://crates.io/crates/feedparser-rs) |
 | [`feedparser-rs-node`](crates/feedparser-rs-node) | Node.js bindings | [npm](https://www.npmjs.com/package/feedparser-rs) |
 | [`feedparser-rs-py`](crates/feedparser-rs-py) | Python bindings | [PyPI](https://pypi.org/project/feedparser-rs) |
 

crates/feedparser-rs-core/README.md

@@ -7,8 +7,8 @@ This is the core parsing library that powers the Python and Node.js bindings.
 ## Features
 
 - **Multi-format**: RSS 0.9x/1.0/2.0, Atom 0.3/1.0, JSON Feed 1.0/1.1
-- **Tolerant**: Bozo flag for malformed feeds (like Python feedparser)
-- **Fast**: Written in Rust, 10-100x faster than Python feedparser
+- **Tolerant**: Bozo flag for graceful handling of malformed feeds
+- **Fast**: Native Rust performance
 - **Safe**: No unsafe code, comprehensive error handling
 - **HTTP support**: Fetch feeds from URLs with compression and conditional GET
 - **Podcast support**: iTunes and Podcast 2.0 namespace extensions
@@ -84,15 +84,9 @@ feedparser-rs = { version = "0.1", default-features = false }
 
 ## Performance
 
-Benchmarks show 10-100x speedup compared to Python feedparser:
+Rust implementation provides significant performance improvements over interpreted alternatives.
 
-| Feed Size | feedparser-rs | feedparser (Python) | Speedup |
-|-----------|---------------|---------------------|---------|
-| 3 KB      | 0.05 ms       | 5 ms                | 100x    |
-| 24 KB     | 0.5 ms        | 50 ms               | 100x    |
-| 237 KB    | 5 ms          | 500 ms              | 100x    |
-
-See [benchmarks/](../../benchmarks/) for detailed benchmark code.
+See [benchmarks/](../../benchmarks/) for benchmark code and methodology.
 
 ## API Documentation
 

crates/feedparser-rs-node/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feedparser-rs",
   "version": "0.1.0",
-  "description": "High-performance RSS/Atom/JSON Feed parser (drop-in feedparser replacement)",
+  "description": "High-performance RSS/Atom/JSON Feed parser for Node.js",
   "main": "index.js",
   "types": "index.d.ts",
   "repository": {

crates/feedparser-rs-py/README.md

@@ -1,16 +1,15 @@
-# feedparser-rs-py
+# feedparser-rs
 
-High-performance RSS/Atom/JSON Feed parser for Python — drop-in replacement for `feedparser`.
+High-performance RSS/Atom/JSON Feed parser for Python with feedparser-compatible API.
 
 ## Features
 
-- 🚀 **10-100x faster** than feedparser (Rust core)
-- 🔄 **100% API compatible** with feedparser 6.x
-- ✅ **Tolerant parsing** with bozo flag for malformed feeds
-- 📦 **Zero dependencies** (pure Rust + PyO3)
-- 🎯 **Supports all formats**: RSS 0.9x/1.0/2.0, Atom 0.3/1.0, JSON Feed 1.0/1.1
-- 🎙️ **Podcast metadata**: iTunes tags, Podcast 2.0 namespace
-- 🛡️ **DoS protection**: Built-in resource limits
+- **Fast**: Native Rust implementation via PyO3
+- **Tolerant parsing**: Bozo flag for graceful handling of malformed feeds
+- **Multi-format**: RSS 0.9x/1.0/2.0, Atom 0.3/1.0, JSON Feed 1.0/1.1
+- **Podcast support**: iTunes and Podcast 2.0 namespace extensions
+- **Familiar API**: Inspired by feedparser, easy migration path
+- **DoS protection**: Built-in resource limits
 
 ## Installation
 
@@ -20,22 +19,14 @@ pip install feedparser-rs
 
 ## Usage
 
-**Same API as feedparser:**
-
 ```python
 import feedparser_rs
 
-# From string
+# Parse from string or bytes
 d = feedparser_rs.parse('<rss>...</rss>')
-
-# From bytes
 d = feedparser_rs.parse(b'<rss>...</rss>')
 
-# From file
-with open('feed.xml', 'rb') as f:
-    d = feedparser_rs.parse(f.read())
-
-# Access data (feedparser-compatible)
+# Access data
 print(d.feed.title)
 print(d.version)  # "rss20", "atom10", etc.
 print(d.bozo)     # True if parsing errors occurred
@@ -47,57 +38,37 @@ for entry in d.entries:
 
 ## Migration from feedparser
 
-**No code changes needed:**
-
 ```python
-# Before
-import feedparser
-d = feedparser.parse(feed_url_or_content)
-
-# After - just change the import!
+# Option 1: alias import
 import feedparser_rs as feedparser
-d = feedparser.parse(feed_url_or_content)
-```
-
-Or use it directly:
+d = feedparser.parse(feed_content)
 
-```python
+# Option 2: direct import
 import feedparser_rs
 d = feedparser_rs.parse(feed_content)
 ```
 
-## Performance
-
-Benchmark parsing 1000-entry RSS feed (10 iterations):
-
-| Library | Time | Speedup |
-|---------|------|---------|
-| feedparser 6.0.11 | 2.45s | 1x |
-| feedparser-rs 0.1.0 | 0.12s | **20x** |
+> **Note**: URL fetching is not yet implemented. Use `requests.get(url).content` to fetch feeds.
 
 ## Advanced Usage
 
 ### Custom Resource Limits
 
-Protect against DoS attacks from malicious feeds:
-
 ```python
 import feedparser_rs
 
 limits = feedparser_rs.ParserLimits(
     max_feed_size_bytes=50_000_000,  # 50 MB
     max_entries=5_000,
-    max_authors=20,              # Max authors per feed/entry
-    max_links_per_entry=50,      # Max links per entry
+    max_authors=20,
+    max_links_per_entry=50,
 )
 
 d = feedparser_rs.parse_with_limits(feed_data, limits)
 ```
 
 ### Format Detection
 
-Quickly detect feed format without full parsing:
-
 ```python
 import feedparser_rs
 
@@ -107,8 +78,6 @@ print(version)  # "rss20", "atom10", "json11", etc.
 
 ### Podcast Support
 
-Access iTunes and Podcast 2.0 metadata:
-
 ```python
 import feedparser_rs
 
@@ -118,98 +87,51 @@ d = feedparser_rs.parse(podcast_feed)
 if d.feed.itunes:
     print(d.feed.itunes.author)
     print(d.feed.itunes.categories)
-    print(d.feed.itunes.explicit)
 
 # Episode metadata
 for entry in d.entries:
     if entry.itunes:
-        print(f"S{entry.itunes.season}E{entry.itunes.episode}")
         print(f"Duration: {entry.itunes.duration}s")
-
-# Podcast 2.0
-if d.feed.podcast:
-    for person in d.feed.podcast.persons:
-        print(f"{person.name} ({person.role})")
 ```
 
 ## API Reference
 
-### Main Functions
+### Functions
 
-- `parse(source)` - Parse feed from bytes, str, or file
-- `parse_with_limits(source, limits)` - Parse with custom resource limits
-- `detect_format(source)` - Detect feed format
+- `parse(source)` — Parse feed from bytes or str
+- `parse_with_limits(source, limits)` — Parse with custom resource limits
+- `detect_format(source)` — Detect feed format without full parsing
 
 ### Classes
 
-- `FeedParserDict` - Parsed feed result
-  - `.feed` - Feed metadata
-  - `.entries` - List of entries
-  - `.bozo` - True if parsing errors occurred
-  - `.bozo_exception` - Error description
-  - `.version` - Feed version string
-  - `.encoding` - Character encoding
-  - `.namespaces` - XML namespaces
-
-- `ParserLimits` - Resource limits configuration
-
-### Feed Metadata
-
-- `title`, `subtitle`, `link` - Basic metadata
-- `updated_parsed` - Update date as `time.struct_time`
-- `authors`, `contributors` - Person lists
-- `image`, `icon`, `logo` - Feed images
-- `itunes` - iTunes podcast metadata
-- `podcast` - Podcast 2.0 metadata
-
-### Entry Metadata
-
-- `title`, `summary`, `content` - Entry text
-- `link`, `links` - Entry URLs
-- `published_parsed`, `updated_parsed` - Dates as `time.struct_time`
-- `authors`, `contributors` - Person lists
-- `enclosures` - Media attachments
-- `itunes` - Episode metadata
-
-## Compatibility
+- `FeedParserDict` — Parsed feed result
+  - `.feed` — Feed metadata
+  - `.entries` — List of entries
+  - `.bozo` — True if parsing errors occurred
+  - `.version` — Feed version string
+  - `.encoding` — Character encoding
 
-This library aims for 100% API compatibility with `feedparser` 6.x. All field names, data structures, and behaviors match feedparser.
-
-Key differences:
-- **URL fetching not implemented yet** - Use `requests.get(url).content`
-- **Performance** - 10-100x faster
-- **Error handling** - Same tolerant parsing with bozo flag
+- `ParserLimits` — Resource limits configuration
 
 ## Requirements
 
 - Python >= 3.9
-- No runtime dependencies (Rust extension module)
 
 ## Development
 
-Build from source:
-
 ```bash
-git clone https://github.com/rabax/feedparser-rs
+git clone https://github.com/bug-ops/feedparser-rs
 cd feedparser-rs/crates/feedparser-rs-py
 pip install maturin
 maturin develop
 ```
 
-Run tests:
-
-```bash
-pip install pytest
-pytest tests/
-```
-
 ## License
 
 MIT OR Apache-2.0
 
 ## Links
 
-- **GitHub**: https://github.com/rabax/feedparser-rs
-- **PyPI**: https://pypi.org/project/feedparser-rs/
-- **Documentation**: https://github.com/rabax/feedparser-rs#readme
-- **Bug Reports**: https://github.com/rabax/feedparser-rs/issues
+- [GitHub](https://github.com/bug-ops/feedparser-rs)
+- [PyPI](https://pypi.org/project/feedparser-rs/)
+- [Issues](https://github.com/bug-ops/feedparser-rs/issues)

crates/feedparser-rs-py/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "maturin"
 [project]
 name = "feedparser-rs"
 version = "0.1.0"
-description = "High-performance RSS/Atom/JSON Feed parser (drop-in feedparser replacement)"
+description = "High-performance RSS/Atom/JSON Feed parser with feedparser-compatible API"
 readme = "README.md"
 license = { text = "MIT OR Apache-2.0" }
 requires-python = ">=3.9"