Enhanced docu for Execution Hooks to show users how to distinguish between SetUp and OneTimeSetUp inside a Hook.

Author: z002Holpp

docs/articles/nunit/extending-nunit/Execution-Hooks.md

@@ -47,6 +47,16 @@ Each hook receives a `HookData` instance:
 
 Use these fields for logging, conditional logic, or adaptive cleanup.
 
+## One-Time vs Per-Test Setup/TearDown
+
+`BeforeEverySetUpHook`/`AfterEverySetUpHook` and `BeforeEveryTearDownHook`/`AfterEveryTearDownHook` run for both per-test and one-time setup/teardown. Inside a hook, the supported way to distinguish the two is the current test context: `Context.Test.IsSuite` is `true` for [OneTimeSetUp]/[OneTimeTearDown] (suite context) and `false` for [SetUp]/[TearDown] (test method context).
+
+See [Example: One-Time vs Per-Test Setup/TearDown](#example-one-time-vs-per-test-setup-teardown) for a complete hook implementation.
+
+## Example: One-Time vs Per-Test Setup/TearDown
+
+[!code-csharp[ExecutionHookAttributeExample](~/snippets/Snippets.NUnit/ExecutionHookExamples.cs#OneTimeVsPerTestSetupTearDownExample)]
+
 ## Example: Measure Time for Setup
 
 [!code-csharp[ExecutionHookAttributeExample](~/snippets/Snippets.NUnit/ExecutionHookExamples.cs#TimingHookAttribute)]

docs/snippets/Snippets.NUnit/ExecutionHookExamples.cs

@@ -30,6 +30,24 @@ public override void AfterEverySetUpHook(HookData hookData)
         }
         #endregion
 
+        #region OneTimeVsPerTestSetupTearDownExample
+        [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class)]
+        public sealed class OneTimeVsPerTestSetupTearDownHookAttribute : ExecutionHookAttribute
+        {
+            public override void BeforeEverySetUpHook(HookData data)
+            {
+                var scope = data.Context.Test.IsSuite ? "OneTimeSetUp" : "SetUp";
+                TestContext.Progress.WriteLine($"{scope}: {data.HookedMethod?.Name}");
+            }
+
+            public override void AfterEveryTearDownHook(HookData data)
+            {
+                var scope = data.Context.Test.IsSuite ? "OneTimeTearDown" : "TearDown";
+                TestContext.Progress.WriteLine($"{scope}: {data.HookedMethod?.Name}");
+            }
+        }
+        #endregion
+
         #region Usage
         [TestFixture]
         [TimeMeasurementHook]