From 7d3ea9821aa7040aa9453f59143d0a1dc4a83ba8 Mon Sep 17 00:00:00 2001
From: offa <8887756+offa@users.noreply.github.com>
Date: Fri, 16 Oct 2026 21:02:09 +0200
Subject: [PATCH 1/2] Add overview to docs

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 1805f04..c44ca0f 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,12 @@
 
 Implementation of *Scope Guards* (`scope_exit`, `scope_success`, `scope_fail`) and `unique_resource` as proposed in [**P0052R10**][1].
 
+- **`scope_exit`:** Executes a callable when the current scope is left
+- **`scope_success`:** Executes a callable only if the scope exits normally (no exception)
+- **`scope_fail`:** Executes a callable only if an exception is thrown during the scope
+- **`unique_resource`:** RAII wrapper that owns a resource and calls a deleter on destruction or reset
+- **`make_unique_resource_checked()`:** Helper that creates a `unique_resource` and releases it if the resource equals an invalid value
+
 
 ## Compatibility
 

From 5c17f50c5ed79ea6b2b837097727aec599ee70b2 Mon Sep 17 00:00:00 2001
From: offa <8887756+offa@users.noreply.github.com>
Date: Sat, 17 Oct 2026 20:56:21 +0200
Subject: [PATCH 2/2] Add examples

---
 README.md | 90 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)

diff --git a/README.md b/README.md
index c44ca0f..1dc0589 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,96 @@ The filenames contain a `.h` extension. To enable the compatible header as speci
 - [*N4853 – C++ Extensions for Library Fundamentals, Version 3*][2] (T. Köppe)
 
 
+## Usage Examples
+
+### scope_exit
+
+```cpp
+#include "scope_exit.h"
+
+void example() {
+    sr::scope_exit guard([] {
+        std::cout << "Cleanup executed when scope exits\n";
+    });
+
+    // Do work ...
+}
+```
+
+### scope_success
+
+```cpp
+#include "scope_success.h"
+
+void example() {
+    sr::scope_success guard{[] {
+        std::cout << "Success: no exception was thrown\n";
+    }};
+
+    // Do work that might throw ...
+}
+```
+
+### scope_fail
+
+```cpp
+#include "scope_fail.h"
+
+void example() {
+    sr::scope_fail guard{[] {
+        std::cout << "Failure: an exception was thrown\n";
+    }};
+
+    // do work that might throw ...
+}
+```
+
+### unique_resource
+
+```cpp
+#include "unique_resource.h"
+
+class Resource {
+    // ...
+};
+
+void example() {
+    sr::unique_resource resource{
+        Resource{"Example resource"},
+        [](Resource r) {
+            // Delete r
+            std::cout << "Resource deleted\n";
+    }};
+
+    auto& res = resource.get();
+    // Use resource ...
+}
+```
+
+### make_unique_resource_checked()
+
+```cpp
+#include "unique_resource.h"
+
+class Resource {
+    // ...
+};
+
+void example() {
+    auto resource = sr::make_unique_resource_checked(
+        Resource{"invalid"},  // invalid value
+        [](Resource r) {
+            // Delete r
+            std::cout << "Resource deleted\n";
+    });
+    // Resource is released if it equals the invalid value
+
+    auto& res = resource.get();
+    // Use resource ...
+}
+```
+
+
 ## License
 
 **MIT License**