Skip to content

Commit daf0821

Browse files
Update README.md. Add FAQ section. #123
1 parent 2616501 commit daf0821

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

README.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ If a method might throw an exception, the caller must either:
2020
✅ Inspired by Java’s checked exceptions<br />
2121
⚙️ Fully opt-in<br />
2222
💡 Analyzer warnings by default — can be elevated to errors<br />
23+
📄 Supports .NET and third-party libraries via XML documentation<br />
2324
🛠 Includes code fixes to help you quickly handle or declare exceptions<br />
2425

2526
---
@@ -210,7 +211,6 @@ When analyzing external APIs (e.g., referenced .NET assemblies), we **do** recog
210211

211212
- We treat documented exceptions from public APIs as "declared" when `[Throws]` is not available.
212213
- This helps maintain compatibility without requiring upstream changes.
213-
- However, this behavior **does not apply** to code within your own solution.
214214

215215
> ⚠️ Summary:
216216
> `<exception>` tags are respected for **interop**, but they are **not a replacement** for `[Throws]` in code you control.
@@ -225,6 +225,14 @@ This is due to a **technical limitation**: the XML documentation files for .NET
225225

226226
**Recommendation:** Target a modern .NET SDK (e.g., .NET 6 or later) to get full analyzer support, including framework exception annotations.
227227

228+
### ❓ What about LINQ support?
229+
230+
**Answer:**
231+
232+
There’s no special support for LINQ at the moment. Since LINQ queries are typically deferred and represented as expression trees or objects, it’s difficult to determine where and when exceptions will actually be thrown.
233+
234+
We may explore better support in the future, but for now, these cases are considered out of scope.
235+
228236
---
229237

230238
## 🤝 Contributing

0 commit comments

Comments
 (0)