docs: spice-rs v3.0.0 release note (#61)

* WIP: v3.0.0 release note

* fix

* more details on query retry

* fix formatting

* fix

* change log

* update contributor list

* update template - ack all contributors

* fix api casing

* fix api case

* fix

* Update docs/release_notes/v3.0.0.md

Co-authored-by: Phillip LeBlanc <phillip@leblanc.tech>

---------

Co-authored-by: Phillip LeBlanc <phillip@leblanc.tech>

Author: Sevenannn

.github/ISSUE_TEMPLATE/end_game.md

@@ -27,7 +27,7 @@ assignees: ''
   - [ ] [docs.spice.ai](https://github.com/spicehq/docs/tree/trunk/sdks/rust-sdk)
 - [ ] Test the [`spice-rs` sample](https://github.com/spiceai/samples/tree/trunk/client-sdk/spice-rs-sdk-sample) using the latest `trunk` SDK version.
 - [ ] Update [release notes](https://github.com/spiceai/spice-rs/blob/trunk/docs/release_notes)
-  - [ ] Ensure any external contributors have been acknowledged.
+  - [ ] Ensure all contributors have been acknowledged.
 - [ ] Verify the version in `Cargo.toml` is correct and match the milestone version.
 - [ ] Run [Test CI](https://github.com/spiceai/spice-rs/actions/workflows/build.yml) and ensure it is green on the trunk branch.
 - [ ] QA DRI sign-off

docs/release_notes/v3.0.0.md

@@ -0,0 +1,93 @@
+# Announcing spice-rs v3.0 🎉
+
+The v3.0 release optimizes the Spice client API, adds support for robust query retry, and supports more custom metadata configurations for spice query.
+
+## What's New in v3.0.0
+
+**Immutable client API**: `Client::query()` now takes `&self` instead of `&mut self`, user can issue multiple simultaneous queries without mutable borrowing.
+
+**Automatic query retry**: Support automatic query retry on transient network or server-side error when obtaining the result stream in `Client::query()`.
+
+**Retryable query stream**: Introducing `RetryableQueryStream` as the returned type of `Client::query()`. This feature provides robust retry of network interruptions during data streaming.
+
+When a connection is reset during streaming, the stream consumer has two options:
+
+- Option 1: Retry Query Stream
+
+```rust
+// When stream consumer continue polling after a ConnectionReset error:
+// 1. The query is automatically reissued
+// 2. Data streaming restarts from the beginning
+
+// Example flow:
+Poll 1: ✅ Received batch1
+Poll 2: ✅ Received batch2
+Poll 3: ❌ SpiceClientError::ConnectionReset error → Continue polling
+Poll 4: ✅ Received batch1* (query restarted automatically)
+Poll 5: ✅ Received batch2*
+Poll 6: ✅ Received batch3*
+...
+```
+
+- Option 2: Stop polling
+
+```rust
+// Stream consumer can stop polling when it receives a ConnectionReset error
+// The stream won't be retried
+
+// Example flow:
+Poll 1: ✅ Received batch1
+Poll 2: ✅ Received batch2
+Poll 3: ❌ SpiceClientError::ConnectionReset  error → Stop polling and handle error
+```
+
+**Expanded support for query parameters**: Support custom `User-Agent` and `Cache-Control` query metadata configurations.
+
+Follow the [Spice OSS quickstart](https://github.com/spiceai/spiceai?tab=readme-ov-file#%EF%B8%8F-quickstart-local-machine) to install and run the spice runtime locally, and query data using the spice-rs SDK:
+
+```rust
+use spiceai::ClientBuilder;
+
+#[tokio::main]
+async fn main() {
+  let client = ClientBuilder::new().build().await.unwrap();
+
+  let data = client.query(
+    "SELECT trip_distance, total_amount FROM taxi_trips ORDER BY trip_distance DESC LIMIT 10;"
+  ).await;
+}
+```
+
+## Contributors
+
+- [@Sevenannn](https://github.com/Sevenannn)
+- [@phillipleblanc](https://github.com/phillipleblanc)
+- [@peasee](https://github.com/peasee)
+- [@digadeesh](https://github.com/digadeesh)
+- [@eadgbear](https://github.com/eadgbear)
+
+## Breaking Changes
+
+- `Client::query()` now takes `&self` instead of `&mut self`, and returns a retryable stream type `RetryableQueryStream`
+
+```rust
+// Old:
+fn query(&mut self, sql: &str) -> FlightRecordBatchStream
+// New:
+fn query(&self, sql: &str) -> RetryableQueryStream
+```
+
+## What's Changed
+
+- Fix a typo in README.md by @digadeesh in https://github.com/spiceai/spice-rs/pull/42
+- feat: Add spice user agent, update for clippy rules by @peasee in https://github.com/spiceai/spice-rs/pull/44
+- Adding custom User-Agent to spice-rs by @eadgbear in https://github.com/spiceai/spice-rs/pull/48
+- Prepend user-supplied user-agent by @phillipleblanc in https://github.com/spiceai/spice-rs/pull/49
+- Fix broken system tls loading and test by @Sevenannn in https://github.com/spiceai/spice-rs/pull/52
+- Support query retry, parameterized query, and cache control header by @Sevenannn in https://github.com/spiceai/spice-rs/pull/51
+- Enable all tests in CI by @Sevenannn in https://github.com/spiceai/spice-rs/pull/55
+- feat: Retryable query stream by @Sevenannn in https://github.com/spiceai/spice-rs/pull/57
+- Fix macos test by @Sevenannn in https://github.com/spiceai/spice-rs/pull/58
+- docs: Add endgame release process by @peasee in https://github.com/spiceai/spice-rs/pull/46
+
+**Full Changelog**: https://github.com/spiceai/spice-rs/compare/v2.0.0...v3.0.0