From 69277e1fb8c22815c67ba6e3a9c6d852ee0f9438 Mon Sep 17 00:00:00 2001
From: Sebastien Marichal <sebastien.marichal@sonarsource.com>
Date: Mon, 23 Dec 2024 15:06:00 +0100
Subject: [PATCH] NET-913 Modify rule S1264: Improve description to match the
 implementation

---
 rules/S1264/csharp/rule.adoc | 64 +++++++++++++++++++++++++++++++++++-
 1 file changed, 63 insertions(+), 1 deletion(-)

diff --git a/rules/S1264/csharp/rule.adoc b/rules/S1264/csharp/rule.adoc
index fe598e7f71a..b6c2654bcda 100644
--- a/rules/S1264/csharp/rule.adoc
+++ b/rules/S1264/csharp/rule.adoc
@@ -1,4 +1,66 @@
-include::../rule.adoc[]
+== Why is this an issue?
+
+Using a `for` loop without its typical structure (initialization, condition, increment) can be confusing. In those cases, it is better to use a `while` loop as it is more readable.
+
+The initializer section should contain a variable declaration to be considered as a valid initialization.
+
+== How to fix it
+
+Replace the `for` loop with a `while` loop.
+
+=== Code example
+
+==== Noncompliant code example
+
+[source,csharp,diff-id=1,diff-type=noncompliant]
+----
+for (;condition;) // Noncompliant; both the initializer and increment sections are missing
+{
+    // Do something
+}
+----
+
+==== Compliant solution
+
+[source,csharp,diff-id=1,diff-type=compliant]
+----
+while (condition)
+{
+    // Do something
+}
+----
+
+==== Noncompliant code example
+
+[source,csharp,diff-id=2,diff-type=noncompliant]
+----
+int i;
+
+for (i = 0; i < 10;) // Noncompliant; the initializer section should contain a variable declaration
+{
+    // Do something
+    i++;
+}
+----
+
+==== Compliant solution
+
+[source,csharp,diff-id=2,diff-type=compliant]
+----
+int i = 0;
+
+while (i < 10)
+{
+    // Do something
+    i++;
+}
+----
+
+== Resources
+
+=== Documentation
+
+* Microsoft Learn - https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/statements/iteration-statements#the-for-statement[The `for` statement]
 
 ifdef::env-github,rspecator-view[]